AgentShare Price API

Base URL:
https://agentshare.dev/api/v1/

Authentication:
Header: X-API-Key
Get key: https://agentshare.dev/pricing

MCP (Model Context Protocol) — remote tools over HTTP:
Streamable HTTP endpoint: https://agentshare.dev/mcp
Send header X-API-Key or Authorization: Bearer <your API key> when connecting.
Human docs: https://agentshare.dev/docs#mcp
Same tools as REST: search, best offer, best under budget, service meta.

Discovery (JSON, no auth):
GET /agent.json                        - Full map: tools, auth, signup, MCP (same as /.well-known/agentshare.json)
GET /.well-known/discovery.json        - Consolidated pointers: same URIs as agent.json (compact index; machine-readable policy)
GET /mcp.json                          - MCP directory listing (registry-friendly; same facts as agent.json)

Curated MCP registry (separate from this API's own MCP tools; human + JSON):
GET /registry                            - Human UI (editor-reviewed listings)
GET /api/v1/registry/entries           - Verified entries JSON
GET /api/v1/public/mcp-registry/summary - Compact counts (public)

Main endpoints:
GET /search?q=<keyword>&limit=<n>     - Search product prices
GET /offers/best?q=<keyword>          - Best offer for a product
GET /offers/best-under-budget?q=...&max_price=... - Best within budget
GET /products/{id}                     - Product detail with prices
GET /meta                             - Discovery (no auth)
GET /agent-capabilities                - Machine-readable API capabilities for agents (no auth)
GET /coverage                          - Data coverage spec: focus vs expanding categories (no auth)
GET /health                           - Health check (no auth)

Legal (agent-friendly JSON, no auth):
GET /legal/index.json                 - Terms + Privacy summaries
GET /legal/terms.json                 - Terms of Service
GET /legal/privacy.json               - Privacy Policy

Purpose:
Provide structured price data for AI agents (incl. robotics & robot power). Sources: Tiki, Shopee, Lazada, Accesstrade.
Response includes freshness_status, data_age_seconds for agent reasoning.

OpenAPI:
https://agentshare.dev/openapi.json

Consolidated machine-readable index (pointers: agent.json, MCP, registry, legal):
https://agentshare.dev/.well-known/discovery.json

OpenAI plugin manifest (agent crawlers also scan this):
https://agentshare.dev/.well-known/ai-plugin.json

MCP stdio client repo (GitHub) — companion llms.txt for the Python MCP package (tools, auth, config; same product as this API):
https://raw.githubusercontent.com/anhmtk/agentshare-mcp/main/llms.txt

This file (same content at /llm.txt and /llms.txt, /api/llm.txt and /api/llms.txt):
https://agentshare.dev/llm.txt
https://agentshare.dev/llms.txt
https://agentshare.dev/api/llm.txt
https://agentshare.dev/api/llms.txt