La API de datos

Empezar

1. Cree una clave en el buscador, en «Mi espacio», pestaña «API». Se le muestra una sola vez: cópiela entonces. Puede tener hasta tres activas y revocar cualquiera cuando quiera.
2. Mándela en cada petición, en la cabecera Authorization: Bearer sdv_….
3. Pida los proyectos con GET /api/v1/proyectos.

curl -H "Authorization: Bearer $SONDEVA_CLAVE" \
     "https://renovables.sondeva.es/api/v1/proyectos?pagina=1&por_pagina=50"

Con filtros (el parámetro f es un JSON, el mismo que usa el buscador; hay que escaparlo en la dirección):

curl -G -H "Authorization: Bearer $SONDEVA_CLAVE" \
     --data-urlencode 'f={"tecnologias":["eolica"],"ccaa":["Aragón"],"mw_min":20,"dias":365}' \
     "https://renovables.sondeva.es/api/v1/proyectos"

La clave es de usted y abre lo que abre su cuenta: no la ponga en una página web, en un programa que corra en el navegador de otras personas ni en un repositorio. La API no admite peticiones desde otras páginas. Si se le escapa, revóquela en «Mi espacio» y cree otra: la anterior deja de abrir al instante.

Conectar su asistente de IA (MCP)

Con el conector, su asistente (Claude, Cursor o cualquiera que use el Model Context Protocol) busca proyectos y lee fichas con su clave, y le contesta con el enlace al anuncio oficial de cada uno. Es un solo fichero de Python, sin nada que instalar: sondeva-mcp.py. Corre en su ordenador; Sondeva no ve sus conversaciones, solo las mismas peticiones que haría su programa, y gasta del mismo cupo.

En Claude Code:

claude mcp add sondeva --env SONDEVA_CLAVE=sdv_… -- python /ruta/a/sondeva-mcp.py

En Claude Desktop, en claude_desktop_config.json:

{"mcpServers": {"sondeva": {"command": "python",
  "args": ["/ruta/a/sondeva-mcp.py"],
  "env": {"SONDEVA_CLAVE": "sdv_…"}}}}

Le da dos herramientas: buscar_proyectos (los filtros de abajo, por páginas) y ver_proyecto (un proyecto por su id). Solo leen.

Plantilla: de la API a un CSV

sondeva-a-csv.py pide todas las páginas de una búsqueda y las guarda en un CSV que Excel abre sin preguntar, con las citas de las fuentes al final. Cambie FILTROS por los suyos y ejecútelo:

SONDEVA_CLAVE=sdv_… python sondeva-a-csv.py proyectos.csv

GET /api/v1/proyectos

Lo que encaja con sus filtros, del más nuevo al más viejo, uno por anuncio (como el Excel). Sin f, todos los proyectos de todo el histórico.

Los filtros (f)

La respuesta

{
  "cupo": {"mes": "2026-10", "usados": 50, "limite": 500},
  "total": 1234, "pagina": 1, "por_pagina": 50, "paginas": 25,
  "items": [
    {"id": "BOE:BOE-B-2026-12345", "fuente": "BOE", "proyecto": "Viento Sur", "fase": "informacion_publica", "mw": 49.9, "...": "..."},
    {"id": "BOE:BOE-B-2026-12346", "fuera_del_cupo": true}
  ],
  "fuentes": ["Boletín Oficial del Estado (Agencia Estatal BOE, datos abiertos)"],
  "nota_ambiental": null
}

total es todo lo que encaja, no solo la página. fuentes son las citas que exige cada boletín de los que salen en la página, y hay que conservarlas si republica los datos.

GET /api/v1/proyectos/<id>

Un proyecto por su id (con los dos puntos escritos tal cual o como %3A). Devuelve {"cupo": …, "proyecto": …}, o 404 si no existe.

El cupo

• Es el mismo que el del Excel. Cada cuenta de Enterprise Plus puede sacar 500 proyectos distintos al mes entre el Excel, el CSV, los informes, la hoja viva y la API. El mes es el de Madrid y el día 1 se empieza de cero.
• Volver a sacar un proyecto no gasta. Repetir la misma petición, o pedir por la API uno que ya sacó en el Excel ese mes, no se descuenta.
• Gasta lo que sale, no lo que se busca. De una búsqueda con miles de resultados solo se descuenta la página que pide.
• Lo que ya no cabe sale como {"id": "…", "fuera_del_cupo": true}, sin más datos. cupo.usados y cupo.limite dicen cómo va el mes.

Los campos de cada proyecto

Son los del Excel, dichos para un programa: las claves están siempre, con null donde el dato no está. Ningún dato de personas físicas: ni quien firma por la sociedad, ni administradores o apoderados, ni correos personales; eso se queda en la ficha del buscador. Lo de la empresa, su web, su correo general y su teléfono (de su propia web), sí sale.

Los campos de lo que dice el texto del anuncio (tensión, superficie, presupuesto, expediente) valen null cuando no se localizan: no significa que el anuncio no lo diga.

Errores

Siempre un JSON con {"error": "…"}.