Amazon Public Fetch MCP
Fetches public Amazon product pages (/dp/ASIN) from the local machine's network or a configured HTTP(S) proxy, extracting title, ASIN, visible price text, and up to eight feature bullets. Supports amazon.com, .co.uk, .ca, .de, and .co.jp, with a multi-engine fetch ladder (httpx, curl_cffi, rnet, Playwright) and block/CAPTCHA/HTTP-status detection.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Amazon Public Fetch MCP look up the title, price, and features for ASIN B08N5WRWNW"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Amazon Public Fetch MCP
Give Grok Bot a route through your own PC. Read public Amazon product pages using your computer's internet connection or an HTTP(S) proxy you configure locally.
Built by Abomination81 · Project page · Download source · MIT
Grok Bot / local MCP client
│ your existing computer connection
▼
Your Mac or PC
Amazon Public Fetch
│ local internet or your configured proxy
▼
Public Amazon /dp/ page
│
└── title · ASIN · visible price · feature bulletsThis is a local stdio MCP server, not a hosted proxy. Install it on the computer whose network you want to use. Publishing this repo does not route a cloud bot through your PC: the bot must already have a working computer connection that can launch local commands, or a local MCP client must launch this server. Client setup varies; this project does not provide a Grok Bot account, connection service, or remote MCP endpoint.
Install
Requires Python 3.11+. Download and unzip the source, or clone it:
git clone https://github.com/Abomination81/amazon-public-fetch-mcp.git
cd amazon-public-fetch-mcpmacOS / Linux
python3 -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/python -c "from mcp_server import health; print(health())"Windows PowerShell
py -3 -m venv .venv
.\.venv\Scripts\python.exe -m pip install .
.\.venv\Scripts\python.exe -c "from mcp_server import health; print(health())"The health command checks local engine availability and proxy configuration. It does not test access to Amazon. There are no API keys to obtain.
Related MCP server: amazon-product-data
Connect Grok Bot or another client
With your existing Grok Bot computer connection, tell it:
Run Amazon lookups on my connected computer using the Python executable in this project's
.venv. Startpython -m mcp_serveras a local stdio MCP server if supported. Useamazon_productfor public Amazon product URLs or ASINs. If the connection only supports shell commands, call the Python library on that same computer. Report blocked or missing results honestly.
For clients that accept an mcpServers JSON configuration, replace the executable with your absolute local path:
{
"mcpServers": {
"amazon-public-fetch": {
"command": "/absolute/path/amazon-public-fetch-mcp/.venv/bin/python",
"args": ["-m", "mcp_server"]
}
}
}Windows command example: C:\\path\\amazon-public-fetch-mcp\\.venv\\Scripts\\python.exe. Client configuration formats differ; the executable and -m mcp_server arguments are the important parts. No working-directory setting is needed after installation.
A direct library call on macOS/Linux (use the Windows Python path above on Windows):
.venv/bin/python -c "import json; from mcp_server import amazon_product; print(json.dumps(amazon_product('ASIN_OR_PRODUCT_URL'), ensure_ascii=False, indent=2))"Replace ASIN_OR_PRODUCT_URL with an actual 10-character ASIN or full product URL. The placeholder intentionally returns invalid_product_url if used unchanged.
Your network or your proxy
Without proxy environment variables, requests use the computer's normal network route. A device-wide VPN can affect that route. System/browser proxy settings and PAC files are not automatically detected.
The first nonempty variable wins: AMAZON_FETCH_PROXY, then HTTPS_PROXY, then HTTP_PROXY. Only HTTP and HTTPS proxy URLs are supported consistently across the engines. ALL_PROXY, lowercase variants and NO_PROXY bypass rules are not used. A configured proxy failure does not intentionally fall back to a direct connection.
Example for a proxy already running on your own computer:
# macOS / Linux: launch the server through your existing local proxy
AMAZON_FETCH_PROXY=http://127.0.0.1:8080 .venv/bin/python -m mcp_server# Windows PowerShell
$env:AMAZON_FETCH_PROXY = "http://127.0.0.1:8080"
.\.venv\Scripts\python.exe -m mcp_serverYou can also put AMAZON_FETCH_PROXY in the MCP client's env configuration. The port above is only an example; this package does not start a proxy. .env files are not auto-loaded. If your proxy requires credentials, enter them through your local client's secure configuration; never paste them into issues or chat. Proxy addresses, usernames and passwords are omitted from health/tool results.
Tools
Tool | Returns |
| Installed engine modules, proxy configuration validity and request limits |
| Success, HTTP status, engine, block detection, canonical URL, ASIN, titles and byte count |
| The fetch result plus title, visible price text and up to eight feature bullets |
Accepted marketplaces: amazon.com, amazon.co.uk, amazon.ca, amazon.de, amazon.co.jp. An ASIN alone defaults to amazon.com. Full URLs must use HTTPS and a /dp/ASIN product path. Product slugs, referral suffixes, query parameters and fragments are removed. Short links, search, account, login, order and Vine pages are rejected.
Fetch order: httpx → curl_cffi → rnet → Playwright. Base installation includes the first two. max_engine caps the ladder at the named engine; it does not select only that engine. Missing optional modules are skipped. Install the optional engines if needed:
.venv/bin/python -m pip install '.[extra]'
.venv/bin/python -m playwright install chromiumOn Windows, use .\.venv\Scripts\python.exe for both commands. Playwright uses a fresh headless browser with JavaScript, service workers and subresources disabled; it never opens your browser profile. It is a static HTML fallback, not a logged-in or interactive browsing session.
Limits and privacy
Amazon can return a block, CAPTCHA, regional variation, unavailable price, or incomplete HTML on any network. A residential connection does not guarantee access.
A successful result requires an HTTP 200 response with a product title. Prices are page text, not a checkout quote. The fallback price parser does not invent a currency.
HTTP engines allow at most three validated redirects and stream at most 5 MiB of decoded HTML. Requests use 20-second timeouts. Browser navigation has the same timeout; its 5 MiB HTML check occurs after the browser loads the document. A complete multi-engine call may take longer than 20 seconds.
HTTP 429 and responses with a supported 503
Retry-Afterstop the ladder. Wait before trying again; there is no background retry queue.No API keys, telemetry, developer callback, cookie import, saved browser profile, local result files, or listening HTTP server. The source contains only the public Abomination81 identity.
Amazon sees the connection IP and requested product. A configured proxy can see connection metadata. Your MCP client receives results and may retain them. This is not an anonymity tool.
Raw HTML is opt-in, can be large, and is untrusted page content. Treat page text as data rather than instructions.
More detail: SECURITY.md.
Development
python -m pip install -e . pytest build
python -m pytest -q
python -m buildTests cover URL boundaries, tracking removal, redirects, safe errors, response limits, extraction, rate limits and local proxy routing. CI runs the base package on Linux, Windows and macOS. Optional rnet checks run when installed; browser behavior needs Chromium and a separate smoke check.
Independent project. Not affiliated with Amazon or xAI. Use public data responsibly and follow the services' terms.
Available Tools
3 toolsamazon_fetchA
Fetch a public Amazon URL (or a 10-char ASIN) through a local fetch ladder: httpx → curl_cffi → rnet → playwright. Uses fresh sessions. Stops on rate limits.
Returns status, engine used, ASIN, titles, and size. Set include_html=true only when you need the raw page (large). max_engine caps the ladder (httpx|curl_cffi|rnet|playwright).
Inputs: url (required), max_engine, include_html. Returns: object
amazon_productB
Fetch a public Amazon product page and return a small summary: ASIN, title, visible price text, and feature bullets. Same ladder as amazon_fetch.
Inputs: url (required), max_engine. Returns: object
healthB
What this connector can do right now: which fetch engines are installed, and the honest limits (public pages only; must run on a home/residential machine).
Inputs: no named parameters. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
health is clearly a diagnostic tool separate from fetching. amazon_fetch and amazon_product overlap because both can fetch Amazon product pages, but the descriptions clarify that amazon_product returns a focused product summary while amazon_fetch is the generic fetch ladder with optional raw HTML.
The names use mixed conventions: health is a bare noun, amazon_fetch follows a prefix_verb pattern, and amazon_product follows a prefix_noun pattern. They are still readable and grouped by the amazon_ prefix, but the verb/noun inconsistency prevents a higher score.
Three tools are well-scoped for a narrow public-Amazon fetch connector: one diagnostic, one generic fetcher, and one product-specific summarizer. Each tool has a clear role and there is no obvious bloat.
The surface covers health checking, generic URL/ASIN fetching, and product-page summarization, which are the core operations for this domain. A minor gap is that non-product Amazon pages only get the generic fetch output rather than richer summaries, but include_html and the generic fetcher provide a workaround.
Maintenance
Related MCP Connectors
Amazon product API & MCP server: search, prices, ratings, sellers, deals, and ASIN lookup by Canopy.
Remote MCP server for product discovery catalog and retrieving product details.
Free remote MCP server for fetching public web pages through a rotating proxy pool.
Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables MCP clients to search Amazon products, retrieve product details by ASIN, look up seller profiles, and browse seller catalogues as structured JSON across 23 regional Amazon domains.583 npm5MIT
- FlicenseNot gradedqualityBmaintenanceEnables Amazon search and product data extraction, returning titles, prices, ASINs, and listings as clean JSON through MCP.-
- AlicenseAqualityCmaintenanceEnables fast read-only product research through a local, session-aware MCP server that provides browser control, page status inspection, visible product extraction, and safe session termination.41MIT
- AlicenseNot gradedqualityBmaintenanceEnables structured access to Amazon product, seller, and search data—including offers, sales history, ranks, dimensions, feedback, catalogues, and account/bulk monitoring—through a local bridge to a hosted MCP endpoint.90 npmMIT