Índice para desenvolvedores

Pesquise issues, pull requests mesclados, READMEs de repositórios e sites de documentação selecionados

O Firecrawl Developer é um índice criado para agentes de programação. Ele abrange issues, pull requests mesclados e READMEs de repositórios públicos de código, além de sites de documentação selecionados, para que um agente possa responder a perguntas sobre o comportamento de código, uma biblioteca ou framework, um contrato de API, uma mensagem de erro ou um bug conhecido com base em fontes primárias, em vez de páginas web genéricas.

• Encontre a issue ou o pull request em que um bug foi relatado e corrigido
• Leia as passagens de um README ou de uma página de documentação que respondem a uma pergunta específica
• Rastreie um contrato de API até o pull request que o alterou
• Recupere a discussão por trás de uma mensagem de erro

Para dar ao seu agente acesso ao Índice para desenvolvedores, recomendamos fortemente usar nossa CLI ou o MCP, juntamente com nossa skill dedicada para desenvolvedores, que você pode instalar com:

npx -y firecrawl-cli@latest setup developer-index

​

Endpoints

Tarefa	Endpoint
Pesquisar no índice para desenvolvedores	GET ou POST /search/developer
Adicionar resultados para desenvolvedor a uma busca na web	POST /search com categories: ["developer"]

​

Pesquise no índice para desenvolvedores

Envie uma pergunta em linguagem natural e receba resultados para desenvolvedor ranqueados, com as passagens correspondentes. Use este endpoint quando quiser apenas fontes para desenvolvedores, com filtros para tipo de resultado, repositório e fonte de documentação.

Uma busca para desenvolvedores custa 2 créditos por 10 resultados, arredondado para cima (1–10 resultados = 2 créditos, 11–20 = 4 créditos e assim por diante). Não é necessária uma chave de API para começar; adicione uma para obter limites de taxa mais altos.

cURL

# Não é necessária uma chave de API para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obter limites de taxa mais altos:
curl -s "https://api.firecrawl.dev/v2/search/developer?query=how%20do%20I%20configure%20retries&k=10"

POST está disponível no mesmo endpoint e é a forma mais simples quando você quiser enviar filtros de array como JSON:

cURL

# Não é necessária uma chave de API para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obter limites de taxa mais altos:
curl -X POST https://api.firecrawl.dev/v2/search/developer \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do I configure retries",
    "k": 10,
    "types": ["issue", "pull_request"]
  }'

Cada resultado contém um id estável, como issue:owner/repo#123, uma url e os passages correspondentes em markdown, preservando tabelas e blocos de código. O tipo de artefato é codificado no prefixo de id: doc:, issue:, pull_request: ou readme:. Muitas vezes, title está ausente em resultados doc, quando a página de origem não tem um título utilizável. Nesses casos, use a url em vez de presumir que o campo está presente.

Quando você restringe uma busca com sources ou repos, a resposta os retorna com uma flag indexed para cada entrada, para que você possa diferenciar um id que não está no índice de uma consulta que simplesmente não encontrou nada. Consulte a referência da busca para desenvolvedores para ver o formato do retorno.

Filtros opcionais restringem a busca:

• k define quantos resultados são retornados, com padrão de 10, e passages define quantas passagens correspondentes cada resultado inclui
• types seleciona quais entre doc, issue, pull_request e readme devem ser pesquisados
• repos restringe a parte do índice referente ao repositório, e sources restringe a parte da documentação
• skills definido como only limita a busca a arquivos de skills de agentes indexados
• language, topic, license, min_stars, max_stars, archived e fork filtram atributos do repositório, como language=Rust, topic=async ou license=MIT

Esses sete filtros descrevem um repositório de código. Portanto, enviar um deles sem restringir sources não retorna resultados doc. Leia como os filtros de repositório restringem uma busca antes de usar um deles.

Consulte a referência da busca para desenvolvedores para ver o tipo e os limites de cada filtro, como repos e sources restringem uma busca e o esquema completo da resposta.

Os SDKs de Python e Node acessam o índice para desenvolvedores pela categoria developer mostrada abaixo. Eles não expõem um método dedicado para este endpoint; portanto, chame-o por HTTP, pela CLI ou pelo MCP.

​

Adicione resultados para desenvolvedores a uma busca na web

Passe developer como a única entrada no array categories de /search. A resposta retorna resultados para desenvolvedores no grupo padrão web, cada um marcado com category: "developer". A categoria developer não pode ser combinada com outras categorias.

Nenhuma chave de API é necessária para começar — /search aceita solicitações sem chave, e a categoria developer vem incluída, sujeita à cota sem chave. Envie uma chave para limites de taxa mais altos.

cURL

# Nenhuma chave de API é necessária para começar; adicione -H "Authorization: Bearer $FIRECRAWL_API_KEY" para limites de taxa mais altos:
curl -X POST https://api.firecrawl.dev/v2/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do I configure retries",
    "categories": ["developer"],
    "limit": 10
  }'

Os resultados para desenvolvedor contêm url, title, description e position, com a mesma estrutura de um resultado web, além de category: "developer". Os usuários dos SDKs os acessam em result.web.

Esta interface retorna a estrutura de resultado web, não a estrutura de resultado para desenvolvedor ranqueado. Para as passagens correspondentes e os filtros de índice, use o endpoint de busca para desenvolvedores.

O servidor MCP hospedado expõe ambas as interfaces, e nenhuma delas grava nada. Consulte as ferramentas MCP para saber mais sobre firecrawl_developer_search, sobre resultados para desenvolvedor por meio de firecrawl_search e sobre qual das duas o conjunto de ferramentas sem chave inclui.