# How to integrate Diffbot MCP with OpenClaw ```json { "title": "How to integrate Diffbot MCP with OpenClaw", "toolkit": "Diffbot", "toolkit_slug": "diffbot", "framework": "OpenClaw", "framework_slug": "openclaw", "url": "https://composio.dev/toolkits/diffbot/framework/openclaw", "markdown_url": "https://composio.dev/toolkits/diffbot/framework/openclaw.md", "updated_at": "2026-05-12T10:08:44.324Z" } ``` ## Introduction OpenClaw is the fastest growing agent harness out there, which can work 24/7 to automate almost any kind of tasks. However, its capabilities are limited to the tools it has access to. Composio allows your OpenClaw to access Diffbot with authentication management handled for you. You can execute actions on Diffbot via your favorite OpenClaw interface (Telegram, WhatsApp, TUI, etc), whichever you prefer. ## Also integrate Diffbot with - [OpenAI Agents SDK](https://composio.dev/toolkits/diffbot/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/diffbot/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/diffbot/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/diffbot/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/diffbot/framework/codex) - [Hermes](https://composio.dev/toolkits/diffbot/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/diffbot/framework/cli) - [Google ADK](https://composio.dev/toolkits/diffbot/framework/google-adk) - [LangChain](https://composio.dev/toolkits/diffbot/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/diffbot/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/diffbot/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/diffbot/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/diffbot/framework/crew-ai) ## TL;DR ### Why use Composio? Apart from a managed and hosted MCP server, you will get: - Programmatic tool calling allows LLMs to write its code in a remote workbench to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling. - Handling Large tool responses out of LLM context to minimize context rot. - Dynamic just-in-time access to 20,000 tools across 1000+ other Apps for cross-app workflows. It loads the tools you need, so LLMs aren't overwhelmed by tools you don't need. ## Connect Diffbot to OpenClaw ### How to install Diffbot with OpenClaw ### Using Composio API Key and Setup Prompt - Go to [dashboard.composio.dev](https://dashboard.composio.dev/login?next=/~/org/connect/clients/openclaw&utm_source=toolkits&utm_medium=framework_template&utm_campaign=openclaw&utm_content=setup_prompt) - Copy the setup prompt - Run it in your OpenClaw chat interface. - Authenticate Diffbot from the [dashboard](https://dashboard.composio.dev/login?next=/~/org/connect/clients/openclaw&utm_source=toolkits&utm_medium=framework_template&utm_campaign=openclaw&utm_content=authenticate) - Go back to your OpenClaw interface and start asking questions. ### Using OpenClaw/Composio Plugin 1. Install OpenClaw Composio plugin ```bash openclaw plugins install @composio/openclaw-plugin ``` ## What is the Diffbot MCP server, 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. ## Supported Tools | Tool slug | Name | Description | |---|---|---| | `DIFFBOT_COMBINE_ENTITY_PROFILES` | Combine Entity Profiles | Combine multiple entity profiles into a unified view using the Diffbot Knowledge Graph. Returns enhanced person or organization data by matching on identifying attributes like name, email, employer, or URL. Use this to enrich partial entity data, merge duplicate profiles, or verify entity identity. | | `DIFFBOT_CREATE_BULK` | Create Bulk Extract Job | Tool to submit a bulk extract job to process multiple URLs with Extract APIs. Use when you need to process many URLs asynchronously using any Extract API. The job will process URLs in the background and provide downloadable results. | | `DIFFBOT_CREATE_CUSTOM_API` | Create or Update Custom API | Tool to create or update the parameters and ruleset of a Custom API. Use this when you need to define custom extraction rules for specific websites that require tailored parsing logic beyond standard Diffbot APIs. Allows defining URL patterns, CSS selectors, extraction rules, and preprocessing filters to extract structured data from websites with unique layouts. | | `DIFFBOT_CREATE_KG_BULK_ENHANCE` | Create Bulk Enhance Job | Tool to submit a bulk enhance job to enrich multiple entities asynchronously. Use when you need to process many Person or Organization records in batch. The API accepts entity descriptions and returns enriched data from the Diffbot Knowledge Graph. | | `DIFFBOT_DELETE_CUSTOM_API` | Delete Custom API | Tool to delete custom API definitions for a given URL pattern. Removes custom extraction rules from your account. Use when you need to remove previously configured custom APIs. | | `DIFFBOT_DELETE_KG_ENHANCE_BULKJOB` | Delete KG Enhance Bulkjob | Tool to delete an Enhance Bulkjob. Removes the bulk job and its results from the system. Use when cleaning up completed or failed jobs. | | `DIFFBOT_DOWNLOAD_BULK_RESULTS` | Download Bulk Job Results | Tool to download results of a bulk enhance job with filtering options via POST request. Use this to retrieve processed results from a completed or running bulk job. Supports multiple export formats (json, jsonl, csv, xls, xlsx) and various filtering options to customize the output. HTTP 200 indicates results are ready, HTTP 201 means the job is still executing. | | `DIFFBOT_ENHANCE_ENTITY` | Enhance Entity with Knowledge Graph | Enrich a person or organization with comprehensive data from the Diffbot Knowledge Graph. Provide identifiers like name, email, employer, or URL and receive detailed entity information including employment history, education, location, skills, and more. Use when you need to gather all publicly available knowledge about a specific person or organization from billions of web pages. | | `DIFFBOT_EXTRACT_JOB` | Diffbot Extract Job | Tool to extract structured job posting data from job listing pages. Returns job title, company, location, salary, requirements, skills, and other job-related information. Use when you need to parse and structure data from job postings. | | `DIFFBOT_EXTRACT_LIST` | Diffbot Extract List | Tool to extract structured data from list-style pages like news indexes, product listings, and directory pages. Returns an array of items with their titles, links, and descriptions. Use when you need to extract multiple items from a page organized as a list or index. | | `DIFFBOT_GET_ACCOUNT` | Get Diffbot Account Details | Retrieves comprehensive Diffbot account information including subscription plan details, credit balance, usage history, and account status. Returns account holder name, email, current plan, available credits, and daily usage statistics for the past 31 days. Use this to check your account's credit balance, monitor API usage patterns, verify account status, or retrieve account metadata. | | `DIFFBOT_GET_ANALYZE` | Diffbot Analyze | Automatically analyzes a web page to determine its type and extract structured data. The Analyze API intelligently classifies pages into types (article, product, discussion, image, video, organization, etc.) and extracts relevant structured data. Use this when you need to process URLs of unknown type or want automatic extraction without specifying the page type in advance. | | `DIFFBOT_GET_ARTICLE` | Get Article Data | Tool to extract information from articles, including authors, publication dates, and images. Use when you need structured metadata from a web article URL. | | `DIFFBOT_GET_BULK_DATA` | Get Bulk Job Data | Tool to download extracted results from a completed bulk job. Use after a bulk job has finished processing to retrieve the data. Supports JSON and CSV formats. | | `DIFFBOT_GET_BULK_JOB_STATUS` | Get Bulk Job Status | Tool to poll the status of a specific Diffbot Knowledge Graph Enhance bulk job. Use when you need to check the progress, completion status, or details of a bulk enhancement job. | | `DIFFBOT_GET_BULK_RESULTS` | Get Bulk Job Results | Tool to download the results of a completed Enhance Bulkjob. Returns enriched records from the bulk job. Use after a bulk enhance job has completed processing. | | `DIFFBOT_GET_BULK_SINGLE_RESULT` | Get Bulk Single Result | Tool to download the result of a single job within a Diffbot bulk enhance job. Returns enriched entity data for a specific input record by its index. Use after a bulk enhance job has completed to retrieve individual results without downloading the entire dataset. | | `DIFFBOT_GET_CRAWL_DATA` | Get Crawl Data | Download extracted results from a completed crawl job. Returns all structured data extracted during crawl processing (articles, products, etc.). Use after a crawl job has completed to retrieve the collected data. | | `DIFFBOT_GET_DISCUSSION` | Get Discussion Thread | Extract structured discussion threads from web pages including forums, comment sections, product reviews, Reddit discussions, and blog comments. Returns posts with author info, timestamps, content, and hierarchical relationships. Useful for analyzing conversations, gathering feedback, or monitoring discussions. Supported platforms: Native comment systems, Disqus, Facebook Comments, Reddit, forum software, and more. Use this when you need to: - Extract all comments/posts from a discussion thread - Analyze user feedback or reviews - Monitor forum discussions or social media threads - Gather structured conversation data with metadata | | `DIFFBOT_GET_EVENT` | Diffbot Get Event | Tool to extract event details from web pages. Use when you need structured event data such as venue, date, and description. | | `DIFFBOT_GET_IMAGE` | Diffbot Get Image | Tool to extract detailed information about images, including dimensions and recognition data. Use after confirming the image URL is publicly accessible. | | `DIFFBOT_GET_KG_COVERAGE_REPORT_BY_ID` | Get KG Coverage Report by ID | Download Knowledge Graph coverage report by report ID. Returns detailed CSV coverage statistics showing field presence across query results. Use this after generating a coverage report from a DQL query to retrieve the statistical breakdown of field coverage. | | `DIFFBOT_GET_PRODUCT` | Diffbot Get Product | Tool to extract product information such as specifications, prices, availability, and reviews. Use when you need structured product data including specs, pricing, and reviews. | | `DIFFBOT_GET_VIDEO` | Get Video Data | Tool to extract information from videos, including titles, descriptions, and embedded HTML. Use when you need structured video metadata from any web page. | | `DIFFBOT_LIST_BULK_JOBS` | List Bulk Jobs | Tool to list all Bulk jobs associated with a specific token. Use after authenticating to retrieve statuses of all jobs for the account. | | `DIFFBOT_LIST_BULK_JOBS_STATUS_FOR_TOKEN` | List Bulk Jobs Status For Token | Tool to get the status of all bulk enhance jobs for a token. Returns list of all bulk jobs associated with your API token. Use when you need to monitor or retrieve the status of multiple bulk jobs at once. | | `DIFFBOT_LIST_CUSTOM_APIS` | List Custom APIs | Tool to retrieve all Custom APIs and their extraction rules currently defined on your Diffbot token. Use when you need to list, review, or audit custom API configurations for your account. | | `DIFFBOT_MANAGE_CRAWL` | Manage Crawl Job | Manages Diffbot crawl jobs: pause, restart, delete, or view status. Returns list of all active crawl jobs when called without parameters. Use 'name' parameter with action flags (pause=1, restart=1, delete=1) to control specific jobs. | | `DIFFBOT_RESOLVE_LOST_ID` | Resolve Lost ID | Tool to resolve lost IDs in the Knowledge Graph. Use when you need to map a lost identifier to its canonical counterpart for data consistency. | | `DIFFBOT_SEARCH` | Diffbot Knowledge Graph Search | Search the Diffbot Knowledge Graph using DQL (Diffbot Query Language). Query billions of entities including organizations, people, articles, products, and more. Use structured queries to filter by type, fields, and relationships. | | `DIFFBOT_SEARCH_CRAWL_DATA` | Search Crawl Job Data | Tool to query crawl job collections using DQL (Diffbot Query Language). Use when you need to search extracted data from completed crawl or bulk jobs by collection name. | | `DIFFBOT_START_BULK` | Start Bulk Job | Tool to start a Bulk Extract job. Use when processing large numbers of URLs asynchronously. The Diffbot Bulk API uses GET requests with query parameters to create jobs. | | `DIFFBOT_START_CRAWL` | 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. The crawler follows links within the domain, collects structured data (articles, products, etc.), and stores results for download. Use this to systematically extract data from entire websites or sections. Requires Diffbot Plus plan or higher. | | `DIFFBOT_STOP_BULK_JOB` | Stop Bulk Job | Tool to pause (stop) a running Bulk job. Pausing halts further processing of URLs while preserving existing progress. To resume, use the appropriate resume action. Specify the exact job name (case-sensitive) as provided when the job was created. | | `DIFFBOT_STOP_KG_BULK_JOB_BY_ID` | Stop KG Bulk Job By ID | Tool to stop an active Knowledge Graph Enhance bulk job by its ID. Halts processing of a running KG bulk job immediately. Use when you need to stop a specific KG bulk job using its bulkjobId. | ## Supported Triggers None listed. ## Creating MCP Server - Stand-alone vs Composio SDK The Diffbot MCP server provides comprehensive access to Diffbot operations through Composio. Once connected, you can perform all major Diffbot actions directly from OpenClaw using natural language commands. ## Complete Code None listed. ## Conclusion ### Conclusion You've successfully integrated Diffbot with OpenClaw using Composio plugin. Now interact with Diffbot directly from your terminal, Web UI, or any messenger app using natural language commands. Key benefits of this setup: - Seamless integration across TUI, Web UIs, and Messenger apps like Telegram, WhatsApp, Slack, etc. - Natural language commands for Diffbot operations - Managed authentication through Composio - Access to 20,000+ tools across 1000+ apps for cross-app workflows - Programmatic tool calling for complex tool chaining Next steps: - Try asking OpenClaw to perform various Diffbot operations - Explore cross-app workflows by connecting more toolkits like Calendar, Slack, Notion, etc. - Build complex automation scripts that leverage OpenClaw's 24/7 running capabilities ## How to build Diffbot MCP Agent with another framework - [OpenAI Agents SDK](https://composio.dev/toolkits/diffbot/framework/open-ai-agents-sdk) - [Claude Agent SDK](https://composio.dev/toolkits/diffbot/framework/claude-agents-sdk) - [Claude Code](https://composio.dev/toolkits/diffbot/framework/claude-code) - [Claude Cowork](https://composio.dev/toolkits/diffbot/framework/claude-cowork) - [Codex](https://composio.dev/toolkits/diffbot/framework/codex) - [Hermes](https://composio.dev/toolkits/diffbot/framework/hermes-agent) - [CLI](https://composio.dev/toolkits/diffbot/framework/cli) - [Google ADK](https://composio.dev/toolkits/diffbot/framework/google-adk) - [LangChain](https://composio.dev/toolkits/diffbot/framework/langchain) - [Vercel AI SDK](https://composio.dev/toolkits/diffbot/framework/ai-sdk) - [Mastra AI](https://composio.dev/toolkits/diffbot/framework/mastra-ai) - [LlamaIndex](https://composio.dev/toolkits/diffbot/framework/llama-index) - [CrewAI](https://composio.dev/toolkits/diffbot/framework/crew-ai) ## Related Toolkits - [Excel](https://composio.dev/toolkits/excel) - Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management. - [21risk](https://composio.dev/toolkits/_21risk) - 21RISK is a web app built for easy checklist, audit, and compliance management. It streamlines risk processes so teams can focus on what matters. - [Abstract](https://composio.dev/toolkits/abstract) - Abstract provides a suite of APIs for automating data validation and enrichment tasks. It helps developers streamline workflows and ensure data quality with minimal effort. - [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time. - [Agentql](https://composio.dev/toolkits/agentql) - Agentql is a toolkit that connects AI agents to the web using a specialized query language. It enables structured web interaction and data extraction for smarter automations. - [Agenty](https://composio.dev/toolkits/agenty) - Agenty is a web scraping and automation platform for extracting data and automating browser tasks—no coding needed. It streamlines data collection, monitoring, and repetitive online actions. - [Ambee](https://composio.dev/toolkits/ambee) - Ambee is an environmental data platform providing real-time, hyperlocal APIs for air quality, weather, and pollen. Get precise environmental insights to power smarter decisions in your apps and workflows. - [Ambient weather](https://composio.dev/toolkits/ambient_weather) - Ambient Weather is a platform for personal weather stations with a robust API for accessing local, real-time, and historical weather data. Get detailed environmental insights directly from your own sensors for smarter apps and automations. - [Anonyflow](https://composio.dev/toolkits/anonyflow) - Anonyflow is a service for encryption-based data anonymization and secure data sharing. It helps organizations meet GDPR, CCPA, and HIPAA data privacy compliance requirements. - [Api ninjas](https://composio.dev/toolkits/api_ninjas) - Api ninjas offers 120+ public APIs spanning categories like weather, finance, sports, and more. Developers use it to supercharge apps with real-time data and actionable endpoints. - [Api sports](https://composio.dev/toolkits/api_sports) - Api sports is a comprehensive sports data platform covering 2,000+ competitions with live scores and 15+ years of stats. Instantly access up-to-date sports information for analysis, apps, or chatbots. - [Apify](https://composio.dev/toolkits/apify) - Apify is a cloud platform for building, deploying, and managing web scraping and automation tools called Actors. It lets you automate data extraction and workflow tasks at scale—no infrastructure headaches. - [Autom](https://composio.dev/toolkits/autom) - Autom is a lightning-fast search engine results data platform for Google, Bing, and Brave. Developers use it to access fresh, low-latency SERP data on demand. - [Beaconchain](https://composio.dev/toolkits/beaconchain) - Beaconchain is a real-time analytics platform for Ethereum 2.0's Beacon Chain. It provides detailed insights into validators, blocks, and overall network performance. - [Big data cloud](https://composio.dev/toolkits/big_data_cloud) - BigDataCloud provides APIs for geolocation, reverse geocoding, and address validation. Instantly access reliable location intelligence to enhance your applications and workflows. - [Bigpicture io](https://composio.dev/toolkits/bigpicture_io) - BigPicture.io offers APIs for accessing detailed company and profile data. Instantly enrich your applications with up-to-date insights on 20M+ businesses. - [Bitquery](https://composio.dev/toolkits/bitquery) - Bitquery is a blockchain data platform offering indexed, real-time, and historical data from 40+ blockchains via GraphQL APIs. Get unified, reliable access to complex on-chain data for analytics, trading, and research. - [Brightdata](https://composio.dev/toolkits/brightdata) - Brightdata is a leading web data platform offering advanced scraping, SERP APIs, and anti-bot tools. It lets you collect public web data at scale, bypassing blocks and friction. - [Builtwith](https://composio.dev/toolkits/builtwith) - BuiltWith is a web technology profiler that uncovers the technologies powering any website. Gain actionable insights into analytics, hosting, and content management stacks for smarter research and lead generation. - [Byteforms](https://composio.dev/toolkits/byteforms) - Byteforms is an all-in-one platform for creating forms, managing submissions, and integrating data. It streamlines workflows by centralizing form data collection and automation. ## Frequently Asked Questions ### What are the differences in Tool Router MCP and Diffbot MCP? 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. ### Can I use Tool Router MCP with OpenClaw? Yes, you can. OpenClaw 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. ### Can I manage the permissions and scopes for Diffbot while using Tool Router? 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. ### How safe is my data with Composio Tool Router? 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. --- [See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)