Shopgraph

io.github.laundromaticPublished by GitHub account laundromaticv1.0.1Updated Oct 24, 2026

Clean product data from any URL. Schema.org + AI extraction. 200 free calls/month.

Overview

AI-generated overview

Shopgraph turns product page URLs or raw HTML into structured product data, with per-field verification metadata and an agent-readiness score.

What you can do
Extract full product data from a URL: name, price, brand, images, availability and more, using schema.org data with an LLM fallback and per-field provenance metadata in _shopgraph. Extract basic attributes (name, price, brand, availability) faster and cheaper than the full extraction. Parse raw HTML you already hold, without an HTTP fetch, for use after another scraping service. Score a product page 0-100 for agent readiness, covering structured data completeness, semantic richness, UCP compatibility, pricing clarity and inventory signals.
When to use it
Useful when an assistant needs clean, structured product details from ecommerce pages, or when you already have scraped HTML and want it turned into product fields. The scoring tool suits checking how machine-readable a product page is.
Requirements
Runs as a remote endpoint or as a local npm package. No authentication, environment variables or headers are declared. Paid calls require payment; basic extraction includes 50 free calls per month, and the description mentions 200 free calls per month.
Before you install
Calls cost money: enrich_product and enrich_html are $0.02 per call (cached results free), enrich_basic is $0.01 per call after the free tier. Extraction sends page content to the service and may involve an LLM fallback, so third-party processing applies. Results are cached.

Installation

In SourceWeft

  1. Open Shopgraph in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.laundromatic%2Fshopgraph/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "shopgraph": {
      "type": "http",
      "url": "https://shopgraph.dev/mcp"
    }
  }
}

README

This repository has no README.

Tools

4

enrich_product

Extract 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.

Parametersurlrequiredformatforce_refreshinclude_scorepayment_method_idminimum_confidencestrict_confidence_threshold

enrich_basic

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.

Parametersurlrequiredformatforce_refreshinclude_scorepayment_method_idminimum_confidencestrict_confidence_threshold

enrich_html

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.

Parametersurlrequiredhtmlrequiredformatforce_refreshinclude_scorepayment_method_idminimum_confidencestrict_confidence_threshold

score_product

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.

Parametersurlrequiredformatpayment_method_idstrict_confidence_threshold

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.