Diffbot

Servidor MCP Diffbot

Um servidor MCP Diffbot com uma variedade de ferramentas úteis de manipulação de dados web para seu agente ou pipeline de LLM.

O que é Diffbot? Diffbot é uma pequena empresa de pesquisa que constrói IA que estrutura a web. Nossos produtos conectam aplicativos à web estruturada automaticamente, como uma API para toda a web pública.

Ferramentas

🧬 extract

Alternativa à ferramenta de busca web. Ferramentas de busca convencionais retornam 500k+ tokens de HTML ou uma aproximação em markdown do conteúdo da página. Extract classifica a página que está buscando e extrai o conteúdo em uma estrutura JSON significativa e consistente. As respostas são otimizadas para uso mínimo de tokens, mantendo a fidelidade dos dados. Desenvolvido pela Diffbot Extract API.

🔎 search_web

Ferramenta de busca web que classifica precisão, não popularidade. Construída sobre o índice web de primeira parte da Diffbot. O modelo de classificação favorece fortemente fontes primárias em detrimento de fontes secundárias (ex.: comunicado de imprensa > notícia sobre o referido comunicado). Retorna blocos de conteúdo formatados em markdown para citação de fontes. Gerenciamento otimizado de tokens integrado.

🪄 enhance

Ferramenta de consulta web para organizações e pessoas. Diferente da busca web, enhance retornará dados estruturados do Diffbot Knowledge Graph sobre uma organização ou pessoa (por nome, URL ou outra entrada aceitável). Útil para verificar fatos, pesquisa de mercado ou fluxos de trabalho de inteligência de vendas.

🧠 resolve_entities

Reconhece e resolve entidades em texto. Usa o NLP da Diffbot para reconhecer organizações, pessoas, lugares, endereços e outros substantivos próprios em texto. As entidades são resolvidas para IDs de entidade no Diffbot Knowledge Graph, a partir dos quais mais contexto pode ser recuperado usando dql. Mantém as alucinações sob controle e dá à IA o contexto necessário para navegar em pesquisas aprofundadas.

🕷️ crawl

Encontra todos os links em uma página web (a semente) e os extrai todos. Um rastreamento web clássico, com um bônus de extração web ontológica. Use crawl para arquivar documentação, tirar instantâneos de projetos web ou mapeamento de sites.

🎯 dql

Consulta o Diffbot Knowledge Graph por entidades de organizações, pessoas, artigos, lugares e produtos. O Diffbot Knowledge Graph contém um banco de dados de gráfico vinculado em escala wikipediana de organizações, pessoas, artigos (de notícias), lugares e produtos. O Diffbot MCP converte seu prompt em consultas estruturadas (dql) e retorna registros estruturados para pós-análise.

🧭 dql_ontology

Utilitário auxiliar para navegação precisa na ontologia dql. Contém as chaves para toda a referência de ontologia e taxonomia da Diffbot. Usado pelo Diffbot MCP para criar consultas dql precisas. Humanos não precisam tocar nisso, mas fique à vontade para satisfazer sua curiosidade.

Autenticação

Um token Diffbot gratuito é necessário para uso das ferramentas. Obtenha um aqui.

Comece

Início Rápido

A maneira mais fácil de começar é conectar seu cliente MCP diretamente ao servidor MCP remoto hospedado pela Diffbot.

https://mcp.diffbot.com/mcp?token=<YOUR_DIFFBOT_TOKEN>

Este repositório é implantado diretamente no servidor remoto.

Instalação Local

Clone o repositório

git clone git@github.com:diffbot/diffbot-mcp.git

Instale os requisitos

pip install .

Agora você pode executar o servidor com python3 diffbot_mcp_server.py, ou pular esta etapa se for configurar este servidor com um cliente MCP.

(Opcional) Instalação com Docker

Construa a imagem

docker build -t diffbot-mcp .

Configuração com Clientes MCP

Para configurar o Claude Desktop, siga o guia de instalação oficial e use este exemplo de configuração claude_desktop_config.json (substitua as variáveis conforme necessário).

Esta configuração padrão funciona com a maioria dos IDEs e ambientes.

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "<YOUR_DIFFBOT_TOKEN>"
            }
        }
    }
}

Para instalações com Docker, siga esta configuração.

{
    "mcpServers": {
        "diffbot-mcp": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "-e", "DIFFBOT_TOKEN=<YOUR_DIFFBOT_TOKEN>",
                "diffbot-mcp"
            ]
        }
    }
}

{
  "servers": {
    "diffbot-mcp": {
      "type": "http",
      "url": "https://mcp.diffbot.com/mcp/?token=<YOUR_DIFFBOT_TOKEN>"
    }
  }
}

{
	"servers": {
        "diffbot-mcp": {
            "command": "python3",
            "args": [
                "/<YOUR_PROJECT_FOLDER>/diffbot-mcp/diffbot_mcp_server.py"
            ],
            "env": {
                "DIFFBOT_TOKEN": "${input:diffbot-api-key}"
            }
        }
	},
	"inputs": [
		{
			"password": true,
			"id": "diffbot-api-key",
			"type": "promptString",
			"description": "Diffbot API Key"
		}
	]
}

Ajuda e Suporte

Este projeto é construído e mantido por @jeromechoo. Para suporte, abra uma issue e ele responderá o mais rápido possível. Para respostas mais rápidas, escreva para sales@diffbot.com 😜.