How to Use the Diffbot MCP in Windsurf

Q: How does Windsurf use Diffbot to extract product data?

Cascade calls extractproductdata with your target URL to return structured JSON. The agent handles the API response and writes the data directly to your workspace.

Q: Can I query the Diffbot knowledge graph inside Windsurf?

Yes, Cascade executes searchknowledgegraph to find entities matching your specific criteria. You get clean organization or person profiles without leaving your IDE.

Q: How do I configure this Diffbot MCP Server in Windsurf?

Add the server configuration to your mcpconfig.json file under the mcpServers key. Windsurf automatically registers the 12 tools, making them instantly available to Cascade.

Windsurf's Cascade chains Diffbot tools to turn raw web pages into clean, structured JSON without writing fragile CSS selectors.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Diffbot MCP to Windsurf

Create your Vinkius account to connect Diffbot to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Diffbot with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate e-commerce audits with Windsurf Cascade

The `extract_product_data` tool retrieves clean, structured pricing, specifications, and availability directly from any online storefront. Windsurf loads this tool through the MCP Server interface, feeding the live web data straight to your active workspace agent. Your agent then writes the returned JSON payload directly into your local database files. If a product goes out of stock, Cascade automatically triggers `extract_images` to verify visual updates on the page and updates your inventory schema in one autonomous run.

Build rich lead lists inside this MCP Server

The `enhance_company_profile` tool queries Diffbot's knowledge base to populate empty corporate records with real-time funding, headcount, and industry data. Windsurf reads your local CSV of target companies, recognizes the missing fields, and calls this endpoint to fill the gaps. To refine your targeting, Cascade runs `enhance_person_profile` on key executives identified during the company lookup. This workflow executes entirely in the background, leaving you with a fully populated lead sheet ready for your sales team.

Monitor media coverage with autonomous content analysis

The `extract_article_data` tool strips away ads, paywalls, and navigation menus to isolate the actual text, author, and publication date of any online news piece. Cascade uses this clean output to build local markdown summaries of industry trends. When tracking complex discussions, your agent calls `extract_forum_thread` to parse nested comments and user sentiment from community boards. This setup turns raw, messy web discussions into clean datasets that your local analysis scripts can process immediately.

Setup guide

Set up Diffbot MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Diffbot MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Diffbot payment history." If connected, Cascade will call the Diffbot tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "diffbot-alternative-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Diffbot. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Diffbot now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Diffbot MCP in Windsurf

Cascade calls `extract_product_data` with your target URL to return structured JSON. The agent handles the API response and writes the data directly to your workspace.

Yes, Cascade executes `search_knowledge_graph` to find entities matching your specific criteria. You get clean organization or person profiles without leaving your IDE.

Add the server configuration to your `mcp_config.json` file under the `mcpServers` key. Windsurf automatically registers the 12 tools, making them instantly available to Cascade.

Diffbot uses computer vision and machine learning instead of static selectors to read pages. Your Windsurf agent gets consistent data schemas even when sites redesign their frontends.

This MCP Server only transmits target URLs and raw web data directly to Diffbot's secure processing API. Vinkius runs the server in an isolated sandbox, meaning your local source code and workspace files never leave your machine.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript