Connect

Connect your assistant (MCP)

ScrapeWise turns any website into clean, matched, AI-ready product data. Connect your AI assistant once, then ask in your own words. It collects your competitors’ prices, matches them to your own products and shows you the evidence for every match. It tells you the price before anything paid runs.

What a pricing or sales team asks:

• “Compare my prices against these 3 competitors and show me every product where I am more expensive.”
• “Read my last match run and list the products where a competitor is cheaper than me, biggest gap first.”
• “Look up these 20 products on amazon.de and give me the price, rating and number of reviews of each.”
• “Find every shop price on idealo for these EAN codes and show me the three cheapest offers for each.”
• “Show me how you matched my product to the competitor’s: which code, which details and which score decided it.”

Connect with one-click sign-in

How a match is verified

Before you pay for a full run, you can see how each match was made. Every pair carries its own evidence.

1. Codes first. When both sides carry a barcode (EAN) or the maker’s part number, the matcher compares the codes. The same code is the strongest proof, and the pair says so.
2. Then the details. You pick which of your columns to compare with which column of each shop: your title to their name, brand to brand, size to size. Each line gets a score from 0 to 100. Under your Floor it is no match, at or above your Max it is a match, and in between it waits for review. See Steps, Floor and Max.
3. Photos as a check. Switch on the photo check for a group, and product photos can confirm a match, stop a wrong one, or decide the pairs the text left open. See Photo check.
4. You have the last word. Pairs in between wait in Review. You approve or reject them, and your decisions are kept on every next run. See Results and review.

The evidence for every match: what decided it (a code or the text), the step and rule that decided, every line with its own score and result, the photo score when photos were compared, and the checks that fired. In the portal these are the Why matched, Decided by and Lines columns. Your assistant reads the same fields with scrapewise_get_match_evidence, free with a Read key.

How right are the matches? We print no general accuracy number, because it depends on your data: how many products carry a barcode, and how alike the shops’ product names are. Match quality shows it for your own run instead: how many of your products got a match and, where the run can be checked against known codes, how many of the matches are right. Look at it after a first run, before you match your whole list.

Advanced: connect with an API key

MCP (Model Context Protocol) is how an AI assistant such as Claude calls ScrapeWise as a set of tools. For scripts, and for clients that cannot sign in, every client sends your key in the Authorization: Bearer <key> header. Paste a Read key if the assistant should only look. Paste a Full key if it should also create, run, change, delete or use the paid tools.

{
  "mcpServers": {
    "scrapewise": {
      "url": "https://mcp.scrapewise.ai/mcp",
      "headers": { "Authorization": "Bearer [YOUR KEY]" }
    }
  }
}

claude mcp add scrapewise --transport http https://mcp.scrapewise.ai/mcp --header 'Authorization: Bearer [YOUR KEY]'

curl -X POST "https://mcp.scrapewise.ai/mcp" \
  -H "Authorization: Bearer $SCRAPEWISE_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: [SESSION ID FROM INITIALIZE]" \
  -d '{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }'

import os, requests

r = requests.post(
    "https://mcp.scrapewise.ai/mcp",
    headers={
        "Authorization": f"Bearer {os.environ['SCRAPEWISE_KEY']}",
        "Accept": "application/json, text/event-stream",
        "Mcp-Session-Id": "[SESSION ID FROM INITIALIZE]",
    },
    json={"jsonrpc": "2.0", "id": 2, "method": "tools/list"},
)
print(r.text)

const r = await fetch("https://mcp.scrapewise.ai/mcp", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.SCRAPEWISE_KEY}`,
    "Content-Type": "application/json",
    Accept: "application/json, text/event-stream",
    "Mcp-Session-Id": "[SESSION ID FROM INITIALIZE]",
  },
  body: JSON.stringify({ jsonrpc: "2.0", id: 2, method: "tools/list" }),
});
console.log(await r.text());

Many URLs: one automation, one list

To scrape many addresses, give one automation the whole list. Never make one automation per address. The tool is scrapewise_run_scraper_url_list (Full). Retry with the exact same name, so a repeat is not charged twice. The full steps are on Read a website.

Upload a file

If you have one file (CSV, JSON Lines or Excel), the tools scrapewise_create_file_scraper and scrapewise_update_file_scraper_file (both Full) turn it into an upload scraper. Small files go in the call. For a bigger file the tool returns one ready upload command. See Upload a file.

Out of balance, 402 through MCP

When the wallet has no balance and no free requests, a billable tool returns a result with isError: true. The text is HTTP 402 followed by the body with the code WALLET_INSUFFICIENT_BALANCE. The assistant should stop and tell you, not retry. A match run that cannot start answers FLOW_RUN_SERVER_WALLET_LOW instead. Both are explained on Wallet and billing.

Errors you may see

Questions

Last updated 9 November 2026