Kit de desenvolvimento DeepSFetch

Manual completo: 33 guias passo a passo — API, MCP, SDKs, CLI, coleções, monitores, arquivos, integrações e cobrança.

Colete conteúdo da web para agentes de IA e automações com limites explícitos de créditos.

Este kit reúne clientes JavaScript e Python de código aberto, uma ferramenta de linha de comando (CLI) e a integração n8n para a API hospedada do DeepSFetch. Comece com uma página HTML pública, confira o resultado e conecte aos seus projetos.

O kit contém ferramentas de acesso à API. O motor de coleta e o serviço hospedado não estão incluídos. Para executar os exemplos, você precisa de uma conta e de uma chave de API; as coletas consomem créditos do seu espaço de trabalho. Confira os planos atuais.

Obtenha seu primeiro resultado

Requer Node.js 22 ou superior. Crie uma chave em Chaves de API. Na pasta principal do kit, configure a chave para a sessão atual do terminal e execute o exemplo sem dependências:

PowerShell:

powershell

$env:DEEPSFETCH_API_KEY = 'SUA_CHAVE_DEEPSFETCH'
node examples/scrape.mjs https://example.com

macOS / Linux:

export DEEPSFETCH_API_KEY='SUA_CHAVE_DEEPSFETCH'
node examples/scrape.mjs https://example.com

O exemplo envia uma coleta de HTML por HTTP com limite de 3 créditos e troca automática para navegador desativada. Depois acompanha a mesma tarefa até o resultado e imprime o JSON. Esse limite não garante gratuidade nem sucesso da coleta. Páginas que dependem de JavaScript precisam de outra configuração. Consulte primeiros passos para tratar erros e retomar uma tarefa.

Escolha sua integração

Ferramenta	Instalação ou guia	O que está incluído
SDK JavaScript	`npm install @deepsfetch/sdk`	Cliente da API v2 e acompanhamento de tarefas
CLI	`npm install -g @deepsfetch/cli`	Comandos de coleta, tarefas e estimativas
SDK Python	`python -m pip install ./packages/deepsfetch-sdk-python`	Instalação pelo código-fonte; publicação no PyPI pendente
MCP	Guia de conexão remota	Configuração para o servidor MCP hospedado
n8n	Modelos de fluxo e node comunitário	Código do node publicado no npm

A implementação do servidor MCP remoto não está incluída. O node n8n ainda não é verificado pelo n8n. O MCP remoto está no registro oficial. Este kit não anuncia parceria nativa nem motor de coleta para hospedagem própria.

Primeiro uso pela CLI

Depois de instalar a CLI e configurar a chave como mostrado acima:

deepsfetch scrape --file examples/scrape-request.json --wait

A CLI informa a chave de idempotência na saída de diagnóstico. Essa chave identifica a operação para evitar duplicação. Se o resultado do envio for desconhecido, repita a mesma requisição com --idempotency-key A_MESMA_CHAVE. Se já recebeu o ID da tarefa, use deepsfetch job ID_DA_TAREFA --wait para consultar a tarefa existente.

Ferramentas abertas e serviço hospedado

Recurso	Neste kit	DeepSFetch hospedado
SDK JavaScript, SDK Python e CLI	Código e testes	Conexão à API v2
Node comunitário n8n	Implementação em JavaScript	Acesso à integração de coleta
MCP	Guia de conexão	Servidor remoto
Motor de coleta e infraestrutura de navegadores	Não incluídos	Gerenciados pelo DeepSFetch
Contas, créditos, cobrança e painel	Não incluídos	Gerenciados pelo DeepSFetch

Desenvolvimento local

npm install --ignore-scripts
npm test
npm run check

Para executar os testes Python a partir da pasta principal:

python -m pip install ./packages/deepsfetch-sdk-python
python -m unittest discover -s packages/deepsfetch-sdk-python/tests

Os testes usam dados de exemplo e um servidor HTTP local; não enviam coletas pagas. Veja como contribuir, relatar problemas de segurança e acompanhar as próximas etapas.

Links úteis

As ferramentas deste kit usam a licença MIT. O serviço hospedado tem seus próprios termos de uso e limites de créditos.

Teste e participe

Veja o tutorial de primeira coleta, a verificação operacional reproduzível e relate seu primeiro uso.

A comparação autenticada com o Firecrawl inclui resultados, limitações e código reproduzível. O tutorial publicado no DEV acompanha cadastro, primeira coleta e MCP. Encontre também a listagem no Smithery, com instruções e limites no guia MCP.