{"schema_version":"1.0","name":"AgentShare","type":"commerce_price_api","description":"Structured product prices and offers from marketplaces (AI hardware, robotics, drones & robot/RC power) — JSON API plus optional MCP Streamable HTTP.","base_url":"https://agentshare.dev","human_documentation_url":"https://agentshare.dev/docs","discovery_urls":{"this_file":"https://agentshare.dev/agent.json","well_known":"https://agentshare.dev/.well-known/agentshare.json","well_known_discovery_index":"https://agentshare.dev/.well-known/discovery.json","mcp_json":"https://agentshare.dev/mcp.json","meta":"https://agentshare.dev/api/v1/meta","agent_capabilities":"https://agentshare.dev/api/v1/agent-capabilities","health":"https://agentshare.dev/api/v1/health","openapi":"https://agentshare.dev/openapi.json","llm_txt":"https://agentshare.dev/llm.txt","mcp_stdio_repo_llms_txt":"https://raw.githubusercontent.com/anhmtk/agentshare-mcp/main/llms.txt","legal_index":"https://agentshare.dev/legal/index.json","coverage":"https://agentshare.dev/coverage"},"authentication":{"type":"api_key","header":"X-API-Key","note":"Required for /api/v1/search, /api/v1/offers/*, /api/v1/products/*, MCP /mcp. Not required for meta, health, agent.json, /mcp.json."},"signup":{"register":"POST /api/v1/auth/register","register_url":"https://agentshare.dev/api/v1/auth/register","body_json":{"email":"string","password":"string (min 8 chars)"},"returns":"api_key once (same format as agshp_...)"},"api_version":"1.0.0","coverage":{"spec_url":"https://agentshare.dev/coverage","focus_summary":"Focus (high quality, daily updates): AI local hardware (Raspberry Pi, Jetson, SBCs), mini PCs, components, accessories, robotics (kits, arms, servos), drones & robot/RC power (LiPo, LiFePO4, NiMH packs). Expanding/beta: phones, tablets, general consumer electronics, home appliances — canonical list: GET /coverage."},"mcp":{"streamable_http_url":"https://agentshare.dev/mcp","same_key_as_rest":true},"mcp_listings":{"positioning":"Curated, editor-reviewed MCP registry for data, operations, and commerce-adjacent tools—built to pair with AgentShare price and offer APIs, not as a generic open directory.","landing":"https://agentshare.dev/registry","entries_json":"https://agentshare.dev/api/v1/registry/entries","summary_json":"https://agentshare.dev/api/v1/public/mcp-registry/summary"},"tools":[{"name":"search_products","description":"Search products across sources with prices and freshness metadata","method":"GET","path":"/api/v1/search","query_params":["q","limit"],"requires_auth":true},{"name":"best_offer","description":"Lowest in-stock offer for a query","method":"GET","path":"/api/v1/offers/best","query_params":["q"],"requires_auth":true},{"name":"best_offer_under_budget","description":"Best offer under max price","method":"GET","path":"/api/v1/offers/best-under-budget","query_params":["q","max_price"],"requires_auth":true},{"name":"product_detail","description":"Product by id with prices by source","method":"GET","path":"/api/v1/products/{id}","requires_auth":true},{"name":"submit_product_url","description":"Alpha: suggest a marketplace product page URL for catalog coverage (community). JSON body: url (required), notes (optional). Rate-limited; optional X-API-Key raises hourly cap.","method":"POST","path":"/api/v1/products/submit","body_json":{"url":"string (https product page)","notes":"string (optional)"},"requires_auth":false},{"name":"service_meta","description":"Capabilities and endpoint list (no auth)","method":"GET","path":"/api/v1/meta","requires_auth":false}],"data_sources":["aliexpress","accesstrade"]}