Shopgraph
@laundromatic
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
概览
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.
