English Français العربية

Apiguru Amazon Data

السجل الرسمي البحث والويب

Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http apiguru-amazon-data 'https://mcp.apiguru.app/mcp' --header 'X-API-KEY: <Optional. Apiguru API key. Omit it to use the keyless free-probe-then-402 path.>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "apiguru-amazon-data": {
            "type": "http",
            "url": "https://mcp.apiguru.app/mcp",
            "headers": {
                "X-API-KEY": "<Optional. Apiguru API key. Omit it to use the keyless free-probe-then-402 path.>"
            }
        }
    }
}
PYPI package apiguru-mcp
Claude Code 
claude mcp add apiguru-amazon-data -e 'APIGURU_API_KEY=<your apiguru_api_key>' -e 'APIGURU_BASE_URL=<APIGURU_BASE_URL>' -- uvx apiguru-mcp==1.1.57
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "apiguru-amazon-data": {
            "command": "uvx",
            "args": [
                "apiguru-mcp==1.1.57"
            ],
            "env": {
                "APIGURU_API_KEY": "<your apiguru_api_key>",
                "APIGURU_BASE_URL": "<APIGURU_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • APIGURU_API_KEY سري Optional. An Apiguru API key from https://dash.apiguru.app. Without it the server uses the keyless agent gateway: a small free probe budget, then an HTTP 402 payment challenge payable via x402 (USDC on Base).
  • APIGURU_BASE_URL Optional. Override the API base URL. Only needed for self-hosted or staging deployments.
NPM package apiguru-mcp
Claude Code 
claude mcp add apiguru-amazon-data -e 'APIGURU_API_KEY=<your apiguru_api_key>' -e 'APIGURU_BASE_URL=<APIGURU_BASE_URL>' -- npx -y apiguru-mcp@1.1.57
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "apiguru-amazon-data": {
            "command": "npx",
            "args": [
                "-y",
                "apiguru-mcp@1.1.57"
            ],
            "env": {
                "APIGURU_API_KEY": "<your apiguru_api_key>",
                "APIGURU_BASE_URL": "<APIGURU_BASE_URL>"
            }
        }
    }
}

متغيرات البيئة

  • APIGURU_API_KEY سري Optional. An Apiguru API key from https://dash.apiguru.app. Without it the server uses the keyless agent gateway: a small free probe budget, then an HTTP 402 payment challenge payable via x402 (USDC on Base).
  • APIGURU_BASE_URL Optional. Override the API base URL. Only needed for self-hosted or staging deployments.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Apiguru Agent Kit
  2. Install in your agent
  3. Why this exists
  4. Telling us what is broken
  5. What is in this repository
  6. Licence

Apiguru Agent Kit

Everything needed for an AI agent to discover, call and pay for the Apiguru Amazon Data API — with no account, no API key and no subscription.

Try it -- no signup, no headers:

curl 'https://agent.apiguru.app/agent/v1/v2/product-details/B09DJLW458/US'

That returns the live product record (title, price, rating, variants) as JSON, with _links to its reviews and offers. Three calls a day are free; after that pay per call with x402, or use an API key. Agents start at https://agent.apiguru.app/llms.txt.

Install in your agent

ClientHow
Claude Codeclaude mcp add --transport http apiguru https://mcp.apiguru.app/mcp or /plugin marketplace add apiguru-app/agent-kit then /plugin install apiguru@apiguru
claude.ai, Claude Desktop, ChatGPTadd connector https://mcp.apiguru.app/account and sign in
Codex CLIcodex mcp add apiguru --url https://mcp.apiguru.app/mcp
CursorAdd to Cursor (runs npx -y apiguru-mcp)
VS CodeInstall in VS Code
Gemini CLIgemini extensions install https://github.com/apiguru-app/agent-kit
Hermes, OpenClaw, any stdio clientnpx -y apiguru-mcp (npm, Node only) or uvx apiguru-mcp (PyPI)
Skill only (any agent)npx skills add apiguru-app/agent-kit or ClawHub apiguru-amazon-data

Why this exists

The API is gated behind register → verify email → get key → top up. Every step assumes a human. Agents cannot do any of it, so agent traffic bounces off the front door.

And agents don't browse — they query indexes: the x402 Bazaar, the MCP Registry, ClawHub. Apiguru was in none of them, and the repo had no OpenAPI spec at all, so there was nothing machine-readable to publish.

Telling us what is broken

Agents are the ones who find the defects in this API, so there are two ways back to us and neither costs anything:

  • GitHub issues — preferred: https://github.com/apiguru-app/agent-kit/issues. A thread can hold a reply, and a fix gets linked back to it.
  • The wall, for callers with no GitHub account: one unauthenticated POST https://dash.apiguru.app/api/v1/feedback with {"message": "...", "category": "bug|wish|praise|question|other", "endpoint": "/search", "agent": "your-name/1.0", "contact": "optional"}. No key, no signup, never billed. Read it at https://dash.apiguru.app/feedback, or GET the same URL for JSON.
  • Over MCP: the free send_feedback tool. From the skill: python scripts/probe.py feedback --message "..." --category bug.

This is not decoration. 1.1.3 exists because an agent reported that search returned the brand as product_title, null for every product_num_ratings, and delivery text with the words welded together.

What is in this repository

PathWhat it is
skill/apiguru-amazon-data/The agent skill: SKILL.md, references, and scripts/probe.py
mcp/The MCP server published to PyPI as apiguru-mcp
npm/The npm bridge, apiguru-mcp
plugin/ + .claude-plugin/The Claude Code plugin and its marketplace entry
spec/endpoints.json and the generated openapi.json / llms.txt

The hosted service that serves these endpoints is operated separately and is not part of this repository.

Licence

See LICENSE.

الأسئلة الشائعة

ما هو Apiguru Amazon Data؟

Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.

كيف أثبّت Apiguru Amazon Data؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http apiguru-amazon-data 'https://mcp.apiguru.app/mcp' --header 'X-API-KEY: <Optional. Apiguru API key. Omit it to use the keyless free-probe-then-402 path.>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Apiguru Amazon Data إلى مفتاح API؟

نعم. يتطلب APIGURU_API_KEY, X-API-KEY، وتضبطها في إعداداته.

هل Apiguru Amazon Data مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Apiguru Amazon Data؟

ينشره apiguru-app. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.