Yahoo! Shopping MCP

An open-source, community-maintained MCP server for the Yahoo! Shopping Item Search API v3. It provides read-only product search through Streamable HTTP and can be run locally or self-hosted with Docker.

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: https://non-official-yahoo-shopping-mcp.notelligent.app/mcp
• Health check: https://non-official-yahoo-shopping-mcp.notelligent.app/healthz
• Root health check: https://non-official-yahoo-shopping-mcp.notelligent.app/

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

• Read-only search_products tool for Yahoo! Shopping product search
• Keyword, JAN code, price, stock, condition, shipping, sorting, category, brand, seller, image-size, and pagination filters
• 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 server uses the MCP Streamable HTTP transport:

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

The server is bound to loopback by default. An unauthenticated endpoint is not automatically an internet-public endpoint; if you expose it, add network, reverse-proxy, rate-limit, logging, and data-retention controls appropriate to your deployment.

Local plugin package

The repository includes metadata for local use:

• .codex-plugin/plugin.json: local plugin metadata, prompts, and logo
• .mcp.json: local MCP client configuration
• assets/logo.svg: product-search icon

These files do not provide a store listing or a shared hosted service. Start your own server and configure your own Yahoo Client ID before using them.

Quick start

Requirements:

... View full README on GitHub