Índice para desenvolvedores

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 skills add firecrawl/cli@firecrawl-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.

# 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"

firecrawl developer "how do I configure retries" --limit 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 no array categories de /search quando você já estiver chamando /search e quiser que os resultados para desenvolvedores sejam ponderados junto com os resultados web comuns em uma única chamada. A API os retorna em um grupo developer ao lado de web, e ambos os SDKs expõem esse grupo como .developer. 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.

# 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
  }'

firecrawl search "how do I configure retries" --categories developer --limit 10

from firecrawl import Firecrawl

firecrawl = Firecrawl(api_key="fc-YOUR-API-KEY")

result = firecrawl.search(
    "how do I configure retries",
    categories=["developer"],
    limit=10,
)
for item in result.developer or []:
    print(item.url, item.title)

import { Firecrawl } from "firecrawl";

const firecrawl = new Firecrawl({
  // Nenhuma chave de API é necessária para começar; adicione uma para limites de taxa mais altos:
  // apiKey: "fc-YOUR-API-KEY",
});

const result = await firecrawl.search("how do I configure retries", {
  categories: ["developer"],
  limit: 10,
});
for (const item of result.developer ?? []) {
  console.log(item.url, item.title);
}

Os resultados para desenvolvedor nesse grupo contêm url, title, description e position, com a mesma estrutura de um resultado web, além de category: "developer". Os resultados web na mesma resposta não têm category; portanto, use esse campo para distinguir os dois grupos caso você os mescle. Os resultados para desenvolvedor vêm em seu próprio grupo, não em web; os usuários dos SDKs os acessam com result.developer. 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.

Primeiros passos

Endpoints principais

Mais

Guias de início rápido

Guias para desenvolvedores

Webhooks

Casos de uso

Outros

Como contribuir

Índice para desenvolvedores

Endpoints

Pesquise no índice para desenvolvedores

Adicione resultados para desenvolvedores a uma busca na web

​Endpoints

​Pesquise no índice para desenvolvedores

​Adicione resultados para desenvolvedores a uma busca na web

Endpoints

Pesquise no índice para desenvolvedores

Adicione resultados para desenvolvedores a uma busca na web