# Desarrolladores y agentes

crosbynews.com está hecho para que lo lean tanto las máquinas como las personas. Todo lo de abajo es público y gratuito, sin clave de API ni registro. Los datos provienen del dominio público del gobierno de EE. UU. (NWS/NOAA); atribúyelos como «U.S. National Weather Service». La API y el servidor MCP se ofrecen en inglés.

## API JSON

Cada conjunto de datos del sitio es un endpoint JSON con CORS abierto (Access-Control-Allow-Origin: *) y sin límites de tasa. Los endpoints consultados con frecuencia también admiten GET condicional (ETag / If-None-Match → 304):

- [/api/weather](/api/weather) — condiciones actuales, por hora, pronóstico a 7 días, alertas, sensación térmica y horas de sol
- [/api/water](/api/water) — nivel y caudal de ríos/arroyos y etapas de inundación del NWS
- [/api/news](/api/news) — titulares locales recientes del área de Crosby
- [/api/calendar](/api/calendar) — próximos eventos escolares de Crosby ISD
- [/api/health](/api/health) — estado del servicio y antigüedad de la caché

## Especificaciones y descubrimiento

Descripciones legibles por máquinas y un catálogo de descubrimiento:

- [/openapi.json](/openapi.json) — descripción OpenAPI 3.1 de cada endpoint
- [/.well-known/api-catalog](/.well-known/api-catalog) — catálogo de API RFC 9727 (linkset)

## Markdown en cada página

Cualquier página devuelve Markdown limpio en lugar de HTML si envías un encabezado Accept: text/markdown o agregas ?format=md — útil para LLM y flujos de texto.

- [/es/weather?format=md](/es/weather?format=md) — el pronóstico, en Markdown
- [/llms.txt](/llms.txt) — resumen del sitio en lenguaje sencillo para LLM (llmstxt.org)

## Servidor MCP

Un servidor del Protocolo de Contexto de Modelo sin estado (Streamable HTTP, JSON-RPC) expone los datos como herramientas invocables — get_current_conditions, get_forecast, get_alerts, get_river_levels, get_crosby_news, get_school_events — además de un prompt crosby_briefing y recursos legibles.

Conéctate desde Claude Code: claude mcp add --transport http crosbynews https://crosbynews.com/mcp

- [/mcp](/mcp) — endpoint MCP (POST JSON-RPC); un GET muestra una página explicativa
- [Tarjeta del servidor MCP](/.well-known/mcp/server-card.json) — metadatos de descubrimiento

## Habilidades para agentes

Un índice de descubrimiento agentskills.io (v0.2.0) apunta a un SKILL.md real para los datos del clima de Crosby; su digest es un hash del archivo en tiempo de ejecución, así que no pueden desincronizarse.

- [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json) — índice de descubrimiento de habilidades

## Feeds RSS

Sigue las alertas y las noticias locales en cualquier lector de feeds — el canal de notificaciones sin cuentas ni rastreo:

- [/alerts.xml](/alerts.xml) — alertas activas del NWS (RSS 2.0; vacío cuando no hay ninguna)
- [/news.xml](/news.xml) — titulares seleccionados del área de Crosby (RSS 2.0)

## Términos y atribución

Público y sin autenticación, sin límites de tasa — sé razonable con la frecuencia de consulta (los datos se actualizan cada 15 minutos). Los datos meteorológicos y de agua son de dominio público del gobierno de EE. UU. (NWS y NOAA); los titulares enlazan a sus editores originales.

crosbynews.com es un proyecto independiente y no está afiliado al Servicio Meteorológico Nacional, la NOAA, Crosby ISD ni ninguna agencia gubernamental.

---
[crosbynews.com](https://crosbynews.com/es) · clima para Crosby, Texas