Shopgraph
@laundromatic
About Shopgraph
AI shopping agents need structured product data to compare prices, check availability, and make decisions. Shopify Catalog covers Shopify merchants. Google UCP covers Google Shopping. ShopGraph covers everything else — the DTC brands, independent retailers, and niche suppliers th
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"shopgraph": {
"type": "url",
"url": "https://shopgraph.dev/mcp"
}
}
}Tools
4Extract comprehensive product data from a URL including name, price, brand, images, availability, and more. Uses schema.org structured data when available, with LLM fallback. Costs $0.02 per call (cached results are free). Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.
Extract basic product attributes from a URL (name, price, brand, availability). Faster and cheaper than enrich_product. 50 free calls/month — no payment needed. Paid: $0.01 per call after free tier. Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.
Extract product data from raw HTML you already have (no HTTP fetch needed). Ideal when using Bright Data, Firecrawl, or any scraping API — pipe the HTML through ShopGraph for structured product data. Uses schema.org + LLM fallback. Costs $0.02 per call (cached results are free). Each field carries verification metadata in _shopgraph: provenance (field_method — which source/tier produced it: schema_org, llm, or hybrid), freshness (field_freshness — recency + volatility_class, for volatile fields like price & availability), and abstain (a field is null when ShopGraph cannot verify it on the page). Rely on provenance, freshness, and the abstain signal to decide what to trust.
Extract product data and return agent-readiness score (0-100). Scores structured data completeness, semantic richness, UCP compatibility, pricing clarity, and inventory signals. Full scoring breakdown included.
Overview
What is Shopgraph?
Shopgraph is a Model Context Protocol server that extracts structured product data from URLs using Schema.org data and AI fallback, targeting agents that need product info from the open web where platform APIs are unavailable. It bills per API call via Stripe MPP.
How to use Shopgraph?
Install with npm install, set STRIPE_TEST_SECRET_KEY and GOOGLE_API_KEY in .env, then build and run via npm start (stdio) or npm run start:http (HTTP). Agents connect via MCP and call enrich_product or enrich_basic with a URL and optional payment_method_id.
Key features of Shopgraph
- Schema.org extraction with 0.95 confidence
- Gemini LLM fallback for pages without structured data
- Pay-per-call billing via Stripe MPP
- Cached results returned free (24‑hour TTL)
- Playwright browser fallback for JS‑rendered or bot‑blocked pages
- Two tools:
enrich_product($0.02) andenrich_basic($0.01)
Use cases of Shopgraph
- Gather product details from e‑commerce sites lacking public APIs
- Enrich agent‑driven shopping comparisons with structured data
- Extract basic product attributes (name, price, currency) for quick checks
- Obtain reliable product data from pages that require JavaScript rendering
FAQ from Shopgraph
How does Shopgraph handle payment?
Unauthenticated calls receive a 402 challenge with MPP payment details; authenticated calls with a payment_method_id are processed and billed per tool price.
What data extraction methods does Shopgraph use?
Primary extraction from Schema.org markup (0.95 confidence); if none found, Gemini LLM fallback (0.7+ confidence); Playwright browser fallback for bot‑blocked or JS‑rendered pages.
Are cached results free?
Yes, results returned from cache within the 24‑hour TTL are free of charge.
What runtime dependencies does Shopgraph require?
Node.js, with environment variables STRIPE_TEST_SECRET_KEY and GOOGLE_API_KEY; optionally, a Playwright browser for the JS‑rendering fallback.
Where does Shopgraph run?
The server can run via stdio (local MCP client) or HTTP (for Vercel/remote deployment). The MCP endpoint is https://shopgraph.dev/mcp.
Frequently asked questions
How does Shopgraph handle payment?
Unauthenticated calls receive a 402 challenge with MPP payment details; authenticated calls with a `payment_method_id` are processed and billed per tool price.
What data extraction methods does Shopgraph use?
Primary extraction from Schema.org markup (0.95 confidence); if none found, Gemini LLM fallback (0.7+ confidence); Playwright browser fallback for bot‑blocked or JS‑rendered pages.
Are cached results free?
Yes, results returned from cache within the 24‑hour TTL are free of charge.
What runtime dependencies does Shopgraph require?
Node.js, with environment variables `STRIPE_TEST_SECRET_KEY` and `GOOGLE_API_KEY`; optionally, a Playwright browser for the JS‑rendering fallback.
Where does Shopgraph run?
The server can run via stdio (local MCP client) or HTTP (for Vercel/remote deployment). The MCP endpoint is `https://shopgraph.dev/mcp`.
Basic information
More Other MCP servers
Unity MCP ✨
justinpbarnettUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.
EverArt
modelcontextprotocolModel Context Protocol Servers
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Figs, Relationship Expert
Figs O'Sullivan, LMFTCouples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep
Blender
ahujasidOpen-source MCP to use Blender with any LLM
Comments