convez.ai
MCP ServerIntegração & APIsIntermediário
justadityaraj

Amazon.in MCP Server

justadityaraj/amazon-in-mcp

Busca e compara produtos Amazon.in direto do seu LLM

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite LLMs buscar e comparar produtos no Amazon.in em tempo real. Retorna listagens ranqueadas, ofertas mais baratas, melhor custo-benefício e histórico de preços via Keepa — tudo sem APIs pagas, apenas scraping com rotação de user agents.

Instalação

$npx convez-ai justadityaraj/amazon-in-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
10
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 4 dias
Versão
v0.2.0
Issues abertas
18
Contribuidores
1

Casos de uso

  • Encontrar produtos com melhor custo-benefício na Amazon.in
  • Comparar preços e disponibilidade em tempo real
  • Obter histórico de preços para decisões de compra

Veredito

Ferramenta prática e sem overhead de APIs para quem trabalha no mercado indiano. Implementação limpa com scraping confiável, mas dependente da estrutura HTML do site — exige manutenção em caso de mudanças na Amazon.in.

README

A tradução para o português deste README ainda está na fila.


What it does

Three tools your LLM can call against amazon.in:

ToolWhat it returns
search_amazon_in(query, max_results=5)Ranked listings + two convenience picks: cheapest in stock and best value (rating × log10(reviews) / √price)
get_product(asin_or_url)Full product detail — price, MRP, discount, rating, reviews, stock, bullets, brand, seller, delivery
price_history_link(asin_or_url)A Keepa.com chart URL for the amazon.in domain. No network call.

No API keys. No accounts. Runs locally over stdio. Direct HTML scraping with rotating user agents and retry on bot-check pages.


Quick start

1. Install (Claude Code):

git clone https://github.com/justadityaraj/amazon-in-mcp.git
cd amazon-in-mcp && npm install && npm run build
claude mcp add amazon-in -- node "$PWD/dist/index.js"

2. Restart your MCP client (Claude Code, Cursor, Claude Desktop, etc.)

3. Ask:

"Find me a good 1TB external SSD on amazon.in under ₹10,000. Best value pick."

Your LLM will call search_amazon_in, rank by value, and hand back a real product with current price and a Keepa link for price history.


What it looks like

A real call to search_amazon_in("wireless mouse", max_results=3) returns:

{
  "query": "wireless mouse",
  "total_results": 3,
  "results": [
    {
      "asin": "B0CQRNWJM2",
      "title": "ZEBRONICS Blanc Slim Wireless Mouse...",
      "url": "https://www.amazon.in/dp/B0CQRNWJM2?tag=artech-21",
      "price_inr": 423,
      "mrp_inr": 799,
      "rating": 4.0,
      "review_count": 7801,
      "in_stock": true,
      "delivery": "FREE delivery Tomorrow",
      "price_history_url": "https://keepa.com/#!product/12-B0CQRNWJM2"
    }
  ],
  "cheapest_in_stock": { "asin": "...", "price_inr": 199, "...": "..." },
  "best_value":        { "asin": "...", "rating": 4.3, "...": "..." }
}

get_product adds bullets[], brand, seller, discount_percent, availability.


Configure your MCP client

claude mcp add amazon-in -- node /absolute/path/to/amazon-in-mcp/dist/index.js

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "amazon-in": {
      "command": "node",
      "args": ["/absolute/path/to/amazon-in-mcp/dist/index.js"]
    }
  }
}

Same JSON config as Claude Desktop. Drop it into the client's MCP settings file.


Image search

The server intentionally doesn't accept image input — keeps it provider-agnostic. Instead, paste the image into your LLM client, ask it to describe the product, and it'll call search_amazon_in with the right keywords automatically. Works the same in every MCP-capable client.


How "best value" is scored

Among in-stock listings with at least 10 reviews:

$$ \text{score} = \frac{\text{rating} \times \log_{10}(\text{reviews} + 10)}{\sqrt{\text{price}}} $$

The highest score wins. cheapest_in_stock is just the lowest price_inr among in-stock items — useful when you want raw cheapness instead of balance.


Robustness

UA rotation5 modern desktop UAs (Chrome / Safari / Firefox on Mac / Win / Linux)
Retries3 attempts, exponential backoff on 5xx, 429, and bot-check pages
Bot detectionScans first 8 KB for known CAPTCHA / robot markers
Timeout20 s per request
StateNone. Stdio, no cookies, no session

Expect ~1–5% of requests to fail with a bot-check during heavy use. Wait 30–60 seconds and retry, or run from a different network.


How this project is funded

By default, amazon.in URLs returned by this server include the author's Amazon Associates tag (artech-21). If you (or your LLM) click through and buy something, the author earns a small commission. You pay the same price. This is the only way the project stays free, MIT, and actively maintained.

Override or disable anytime with the AMAZON_IN_AFFILIATE_TAG env var:

ValueBehavior
unsetAuthor's tag (artech-21) — supports the project
yourtag-21Your own Amazon Associates tag
none / off / false / ""No tag, raw amazon.in URLs

Example — your own tag:

{
  "mcpServers": {
    "amazon-in": {
      "command": "node",
      "args": ["/path/to/dist/index.js"],
      "env": { "AMAZON_IN_AFFILIATE_TAG": "yourtag-21" }
    }
  }
}

Roadmap

  • Publish to npm so install becomes npx -y amazon-in-mcp-server
  • Optional Keepa API support (user-supplied key) for real price-history data
  • Filter helpers — min_rating, min_reviews, under_price
  • Smoke-test suite with cached HTML fixtures

Development

npm install
npm run dev      # tsx watch
npm run build    # tsc → dist/
npm start        # node dist/index.js

Test interactively with the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Project layout:

src/
  index.ts        # MCP server + 3 tool registrations
  scraper.ts      # fetch with UA rotation, retry, bot-check
  parse.ts        # cheerio selectors for search + product pages
  constants.ts    # UAs, headers, tuning constants, affiliate config
  types.ts        # SearchResultItem, ProductDetail

Disclaimer

Fetches publicly accessible amazon.in pages for personal research and assistant use. Does not bypass authentication, paywalls, or CAPTCHAs — when Amazon serves a bot-check the tool stops and reports the error.

You are responsible for using this in line with Amazon's Terms of Service and any local laws. No warranty about uptime, accuracy, or fitness for any purpose. DOM selectors are best-effort and may break when Amazon updates its layout. PRs welcome.


License

MIT © Aditya Raj Singh

Issues, bug reports, and selector fixes welcome — Amazon's DOM shifts every few months, so this will break occasionally and need community help to keep current.

Ver o original no GitHub

Bom para

Relacionados