Yahoo! Shopping MCP server

Yahoo! Shopping MCP

An open-source, community-maintained MCP server for read-only Yahoo! Shopping product search through the Yahoo! Shopping Item Search API v3. Search by keyword or JAN code with price, stock, condition, shipping, sorting, category, brand, seller, image-size, and pagination filters. Local and self-hosted deployments use Streamable HTTP; a separate stdio entrypoint is provided for Glama managed hosting and local stdio clients.

This is not an official Yahoo! Shopping, LINE Yahoo, or OpenAI service. The maintainers do not represent, endorse, operate, or guarantee Yahoo! Shopping, the Yahoo! Developer Network, or OpenAI.

Project status and hosted endpoints

This project is intended for self-hosting. It does not provide a guaranteed shared or production-hosted endpoint.

If a Cloudflare Tunnel URL is shared separately by a maintainer for testing, that URL is a temporary verification endpoint. It may be stopped, restarted, changed, or unavailable at any time; it has no uptime, SLA, support, privacy, or data-retention guarantee. Do not use it for production or confidential workloads. Run this server on infrastructure you control instead.

A maintainer-operated sample deployment may be available at:

• MCP endpoint:
• Health check:
• Root health check:

These URLs are provided for demonstration and connectivity checks only. They are not an official Yahoo! or OpenAI service and are not guaranteed to be online, stable, supported, private, or available to any particular user.

The current registry and directory publication status is tracked in docs/PUBLICATION.md.

This is a community implementation. Before using it, independently review the current Yahoo! Developer Network and Yahoo! Shopping API terms, quotas, attribution requirements, content restrictions, and any rules applicable to your jurisdiction and deployment. The maintainers do not guarantee that the implementation or its usage complies with a third-party policy.

Demo

The short demo below shows a Yahoo! Shopping search from ChatGPT and the resulting MCP Apps product carousel.

The GIF is used for inline playback because GitHub does not reliably embed repository-local MP4 files in rendered Markdown. The higher-quality MP4 is available at assets/demo.mp4.

Features

brand, seller, image-size, and pagination filters

• Read-only search_products tool for Yahoo! Shopping product search
• Keyword, JAN code, price, stock, condition, shipping, sorting, category,

• A same-process interval between Yahoo request starts (1 second by default)
• Exponential backoff for Yahoo HTTP 429 responses and a bounded 5xx retry
• Short-lived cache of safety-filtered Yahoo response data
• SQLite-backed application-wide rate limiting
• MCP Apps product carousel with Yahoo attribution
• Conservative filtering of restricted product terms and non-Yahoo URLs
• GET /, GET /healthz, and Streamable HTTP MCP at /mcp

The rate limiter is an application safeguard, not a Yahoo quota guarantee or an SLA. It applies within one process; separate replicas need their own controls.

Protocol and endpoints

The default yahoo-shopping-mcp entrypoint uses the MCP Streamable HTTP transport:

• MCP endpoint: /mcp
• Health endpoint: GET /healthz
• Root health endpoint: GET /
• MCP authentication: none

Shortened. The full README is on GitHub.