Buscar en el Developer Index

Busca issues, pull requests fusionadas y README de repositorios de código público, junto con sitios de documentación seleccionados. Los resultados se clasifican e incluyen los pasajes coincidentes en markdown.

POST está disponible en la misma ruta si quieres pasar filtros de tipo array como JSON.

Los filtros repetibles aceptan cualquiera de las dos formas en GET: un parámetro query repetido como types=issue&types=pull_request, o un valor separado por comas como types=issue,pull_request.

El índice se divide en dos partes, y estos dos filtros las acotan de forma independiente:

• repos acota la parte de repositorios, es decir, los tipos issue, pull_request y readme
• sources acota la parte de documentación, es decir, el tipo doc
• Al pasar ambos, se combinan las dos partes en lugar de intersectarse, por lo que obtendrás resultados coincidentes de cualquiera de las dos

Como cada filtro solo se aplica a una parte, se rechaza un filtro que no puede coincidir con ninguno de los tipos solicitados, en lugar de no devolver resultados de forma silenciosa:

• repos sin ningún tipo de repositorio en types devuelve 400, e informa que repos no puede coincidir con ningún tipo solicitado y que debes añadir tipos de repositorio o eliminar repos
• sources sin doc en types devuelve 400 con sources cannot match any requested type; add doc or drop sources

Los siete filtros de repositorio — language (como Rust), topic (como async), license (como MIT), min_stars, max_stars, archived y fork — describen un repositorio de código. La mayoría de las páginas de documentación del índice proceden de sitios web rastreados que no tienen un repositorio asociado, y ningún dato del repositorio puede incluir o excluir ese tipo de páginas.

Por lo tanto, una solicitud que envía uno de estos filtros sin acotar sources no obtiene resultados de tipo doc. Su respuesta solo contiene evidencia del repositorio: los tipos issue, pull_request y readme, porque la parte de documentación del índice nunca se ejecutó. Esto es intencional, no un fallo del índice.

Para conservar los resultados de documentación, elimina los filtros de repositorio. También puedes acotar la parte de documentación con sources y, después, consultar el valor de sources devuelto en la respuesta para confirmar que el id está indexado.

# No se necesita una clave de API para empezar; añade -H "Authorization: Bearer $FIRECRAWL_API_KEY" para obtener límites de tasa más altos:curl -s "https://api.firecrawl.dev/v2/search/developer?query=how%20do%20I%20configure%20retries&k=10&language=Rust&license=MIT"

sources no es un enum fijo. Acepta ids de fuentes de documentación: cada uno debe ser una cadena no vacía de hasta 512 caracteres, con un máximo de 20 por solicitud. Los ids corresponden a los sitios de documentación del índice, y el conjunto crece con el tiempo.

Para confirmar que un id se resuelve, inclúyelo y consulta el array sources que añade la respuesta. Solo aparece cuando enviaste sources e indica cada id exactamente como lo solicitaste, junto con si está indexado:

{  "success": true,  "results": [],  "sources": [    { "source": "some-docs-site", "indexed": true },    { "source": "unknown-docs-site", "indexed": false }  ]}

indexed: true significa que la fuente tiene una generación publicada, por lo que pueden aparecer pruebas de documentación procedentes de ella. indexed: false significa que nada de ese id puede coincidir, lo que distingue un id que no está en el índice de una consulta que simplemente no encontró nada.

repos se devuelve de la misma forma, como un array repos que indica indexed y un desglose por tipo en types:

{  "success": true,  "results": [],  "repos": [    {      "repo": "firecrawl/firecrawl",      "indexed": true,      "types": { "issue": true, "pullRequest": true, "readme": true }    }  ]}

Para obtener una descripción general del flujo de trabajo, consulta la guía de Developer Index.