X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Diffbot to Claude

Connect Claude Web, Desktop and Cowork to Diffbot MCP. Extract specs and reviews from a product page, summarize key details from a news article url, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Diffbot logoDiffbot
Api Key

Diffbot is an AI-powered platform for extracting and structuring data from any web page. It transforms unstructured web content into rich, linked, and queryable data for analytics, research, and automation.

35 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Diffbot account to Claude via Composio Connect, enabling it to extract specs and reviews from a product page, summarize key details from a news article URL, list all bulk data extraction jobs for your account, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Diffbot with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Diffbot to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Diffbot account

Back in Claude, ask it to connect to Diffbot or give it any Diffbot-related task.

For example, ask Claude to:

  • "Extract specs and reviews from a product page"
  • "Summarize key details from a news article URL"
  • "List all bulk data extraction jobs for your account"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Diffbot account is ready to use.

What is the Diffbot Claude Connector, and what's possible with it?

The Diffbot MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Diffbot account. It provides structured and secure access to web data extraction and analysis, so your agent can extract structured data from web pages, analyze content types, retrieve product details, manage bulk jobs, and search extracted datasets on your behalf.

  • Automatic content analysis and extraction: Let your agent analyze any web page and automatically extract structured data such as articles, products, events, images, or videos using AI-powered tools.
  • Article and discussion thread extraction: Effortlessly pull detailed metadata, authors, publication dates, and full discussion threads from news sites, blogs, forums, and comment sections.
  • Product and event data gathering: Instantly extract comprehensive product specifications, pricing, reviews, and event information including venues, dates, and descriptions from e-commerce or event pages.
  • Bulk job management and search: Enable your agent to list, monitor, and search across large-scale crawl or extraction jobs, making it easy to work with massive web data collections.
  • Account and usage insights: Retrieve your Diffbot account details, plan information, and usage statistics to stay on top of quotas and manage your web data operations efficiently.

Troubleshooting

1. Why does Claude not use the Composio connector for Diffbot?

The connector can show as connected, but Claude must use it in each Diffbot conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Diffbot again.

2. Why does Claude show an MCP server error before Diffbot connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Diffbot.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Diffbot.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Diffbot authorization link not work?

The Composio connector is one server. Your Diffbot account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Diffbot connection.
  • Composio creates a fresh Diffbot authorization link.
  • Open that link in your browser and finish the Diffbot sign-in.

4. Why do Diffbot actions fail after they worked before?

The Diffbot connection can expire or lose permission.

  • Ask Claude to inspect the Diffbot connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Diffbot account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Diffbot.
  • If the action still fails with a permission error, check that the connected account has that permission in Diffbot itself.

5. How do I switch to a different Diffbot account?

Claude can manage the Diffbot connection for you.

  • Ask Claude to disconnect or delete the current Diffbot account.
  • Ask Claude to connect Diffbot again.
  • Open the new Composio authorization link for Diffbot.
  • Sign in with the other Diffbot account in the browser.
  • After the account connects, ask Claude to retry the Diffbot task.

6. Why is my Diffbot connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Diffbot connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Diffbot tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Diffbot.
TOOLS

Supported Tools

Every Diffbot action and event your agent gets out of the box.

Combine Entity Profiles

Combine multiple entity profiles into a unified view using the Diffbot Knowledge Graph.

Create Bulk Extract Job

Tool to submit a bulk extract job to process multiple URLs with Extract APIs.

Create or Update Custom API

Tool to create or update the parameters and ruleset of a Custom API.

Create Bulk Enhance Job

Tool to submit a bulk enhance job to enrich multiple entities asynchronously.

Delete Custom API

Tool to delete custom API definitions for a given URL pattern.

Delete KG Enhance Bulkjob

Tool to delete an Enhance Bulkjob.

Download Bulk Job Results

Tool to download results of a bulk enhance job with filtering options via POST request.

Enhance Entity with Knowledge Graph

Enrich a person or organization with comprehensive data from the Diffbot Knowledge Graph.

Diffbot Extract Job

Tool to extract structured job posting data from job listing pages.

Diffbot Extract List

Tool to extract structured data from list-style pages like news indexes, product listings, and directory pages.

Get Diffbot Account Details

Retrieves comprehensive Diffbot account information including subscription plan details, credit balance, usage history, and account status.

Diffbot Analyze

Automatically analyzes a web page to determine its type and extract structured data.

Get Article Data

Tool to extract information from articles, including authors, publication dates, and images.

Get Bulk Job Data

Tool to download extracted results from a completed bulk job.

Get Bulk Job Status

Tool to poll the status of a specific Diffbot Knowledge Graph Enhance bulk job.

Get Bulk Job Results

Tool to download the results of a completed Enhance Bulkjob.

Get Bulk Single Result

Tool to download the result of a single job within a Diffbot bulk enhance job.

Get Crawl Data

Download extracted results from a completed crawl job.

Get Discussion Thread

Extract structured discussion threads from web pages including forums, comment sections, product reviews, Reddit discussions, and blog comments.

Diffbot Get Event

Tool to extract event details from web pages.

Diffbot Get Image

Tool to extract detailed information about images, including dimensions and recognition data.

Get KG Coverage Report by ID

Download Knowledge Graph coverage report by report ID.

Diffbot Get Product

Tool to extract product information such as specifications, prices, availability, and reviews.

Get Video Data

Tool to extract information from videos, including titles, descriptions, and embedded HTML.

List Bulk Jobs

Tool to list all Bulk jobs associated with a specific token.

List Bulk Jobs Status For Token

Tool to get the status of all bulk enhance jobs for a token.

List Custom APIs

Tool to retrieve all Custom APIs and their extraction rules currently defined on your Diffbot token.

Manage Crawl Job

Manages Diffbot crawl jobs: pause, restart, delete, or view status.

Resolve Lost ID

Tool to resolve lost IDs in the Knowledge Graph.

Diffbot Knowledge Graph Search

Search the Diffbot Knowledge Graph using DQL (Diffbot Query Language).

Search Crawl Job Data

Tool to query crawl job collections using DQL (Diffbot Query Language).

Start Bulk Job

Tool to start a Bulk Extract job.

Start Crawl Job

Initiates a Diffbot crawl job that spiders a website starting from seed URLs and processes discovered pages with a specified Extract API.

Stop Bulk Job

Tool to pause (stop) a running Bulk job.

Stop KG Bulk Job By ID

Tool to stop an active Knowledge Graph Enhance bulk job by its ID.

FRAMEWORKS

How to build Diffbot MCP Agent with another framework

Claude Code logo

Claude Code

Use Diffbot MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Diffbot MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Diffbot MCP with Claude Agent SDK

Codex logo

Codex

Use Diffbot MCP with Codex

OpenClaw logo

OpenClaw

Use Diffbot MCP with OpenClaw

Hermes logo

Hermes

Use Diffbot MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Diffbot MCP with Atomic Agent

Google ADK logo

Google ADK

Use Diffbot MCP with Google ADK

LangChain logo

LangChain

Use Diffbot MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Diffbot MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Diffbot MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Diffbot MCP with LlamaIndex

CrewAI logo

CrewAI

Use Diffbot MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Diffbot MCP with Pydantic AI

AutoGen logo

AutoGen

Use Diffbot MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Diffbot MCP server, the agents and LLMs can only access a fixed set of Diffbot tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Diffbot and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Diffbot tools.

Yes, absolutely. You can configure which Diffbot scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Diffbot data and credentials are handled as safely as possible.

Start with Diffbot.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Diffbot tool your agent needs.Free to start.

Start building