Informes técnicos de GEO

Ejecuta el conjunto de informes GEO técnicos para una URL; después, lista, consulta el estado y recupera cada informe. Los informes se procesan de forma asíncrona. El informe de preparación para agentes, que a veces se denomina preparación para IA, usa report_type=agent_readiness.

GET/technical_geo_reports

Lista los informes más recientes de un tipo de informe GEO técnico para un proyecto. Usa este endpoint para localizar los identificadores y el estado de los informes antes de recuperar un resultado completo.

Parámetros:
  • project_idobligatorio
  • report_typeobligatorio: crawlability, schema, content_readiness, discoverability, site_structure, robots_txt, agent_readiness, llms_txt, ai_visibility
  • status
  • batch_id
  • page
  • per_pagemáximo 100

GET/technical_geo_reports/:id

Consulta el estado actual de un informe. Mientras se procesa, poll_after_seconds es 15. Un informe completado incluye result_data; un informe fallido incluye error_message. Un informe de llms.txt completado devuelve además result_data.content_version, el valor que el cliente envía de vuelta al hacer un cambio en los archivos, y metadata.output_language_code; una vez editados los archivos en la app, a través de la API o a través de MCP, incluye también manually_edited_at y las versiones originales generadas. Un output_language_code con valor null significa que los archivos llms.txt mantienen el idioma propio del sitio web.

  • Parámetros: project_id (obligatorio), report_type (obligatorio) y el id del informe en la URL.

POST/technical_geo_reports

Inicia el paquete completo de nueve informes técnicos de GEO para una URL y un país. La acción «Ejecutar todos los informes» solo se inicia cuando quedan al menos nueve unidades diarias. Cada informe creado correctamente consume una unidad; los que no llegan a crearse no consumen ninguna. La cantidad de unidades diarias asignadas varía según la cuenta. Cada informe se ejecuta en una tarea en segundo plano. La respuesta incluye report_ids, agrupados por tipo de informe, e indica al cliente que consulte periódicamente el estado asociado a cada identificador mediante el endpoint de detalle del informe. Requiere una clave de API con el ámbito read_write.

Cuerpo (JSON):
  • project_idobligatorio
  • urlobligatorio
  • country_codeopcional, por defecto el país del proyecto
  • output_language_codeopcional, idioma ISO 639-1 en el que se escriben los archivos llms.txt, por defecto el idioma del proyecto; auto mantiene el idioma propio del sitio web y se devuelve como auto; el resto de informes del paquete no se ven afectados

PATCH/technical_geo_reports/:id/content

Sustituye los archivos llms.txt y llms-full.txt de un informe de llms.txt completado sin volver a generarlo. edits contiene el texto nuevo completo de uno de los archivos o de los dos, y content_version debe ser igual al result_data.content_version del informe tal como lo leíste la última vez. Si el informe se ha modificado desde entonces, el cambio se rechaza con ERR_INVALID_PARAM, así que vuelve a leer el informe y reenvía el cambio. Un archivo idéntico al texto almacenado se ignora, y el primer cambio guarda una copia de los archivos generados para que puedan restaurarse. changed_files recoge los archivos modificados y está vacío si no se ha modificado ninguno.

  • Cuerpo (JSON): project_id (obligatorio), report_type (obligatorio, debe ser llms_txt), content_version (obligatorio, cadena de texto), edits (obligatorio, objeto con llms_txt, llms_full_txt o ambos, cada uno con el archivo nuevo completo, que no puede estar en blanco ni superar los 200.000 caracteres) y el id del informe en la URL. Requiere una clave de API con ámbito de lectura y escritura y, en el caso de los miembros del equipo, permiso de creación en Optimización GEO.

POST/technical_geo_reports/:id/revert_content

Descarta todos los cambios manuales de un informe de llms.txt y restaura los archivos generados que se guardaron con el primer cambio. manually_edited_at, original_llms_txt_content y original_llms_full_txt_content vuelven a null, y content_version cambia. Devuelve ERR_INVALID_PARAM cuando el informe no tiene cambios manuales.

  • Cuerpo (JSON): project_id (obligatorio), report_type (obligatorio, debe ser llms_txt) y el id del informe en la URL. Requiere una clave de API con ámbito de lectura y escritura. Los miembros del equipo necesitan además el permiso de creación en Optimización GEO.