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 — condiciones actuales, por hora, pronóstico a 7 días, alertas, sensación térmica y horas de sol
/api/water — nivel y caudal de ríos/arroyos y etapas de inundación del NWS
/api/fishing — condiciones del agua del USGS (temp, oxígeno disuelto, pH, turbidez) para aguas de pesca cercanas
/api/tropics — ciclones tropicales activos del Atlántico según el NHC de NOAA (vacío cuando la cuenca está tranquila)
/api/pollen — el conteo diario medido de polen y moho del Departamento de Salud de Houston (mañanas entre semana)
/api/air — el AQI medido de EE. UU. (EPA/AirNow, área metropolitana de Houston) con desglose por contaminante
/api/traffic — incidentes y cierres de carriles en los caminos de Crosby, según Houston TranStar
/api/news — titulares locales recientes del área de Crosby
/api/calendar — próximos eventos escolares de Crosby ISD
/api/health — si el sitio está en línea, cuándo intentó actualizarse cada fuente y si funcionó, y cuándo cambiaron realmente sus datos

Especificaciones y descubrimiento

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

/openapi.json — descripción OpenAPI 3.1 de cada endpoint
/.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. Todas las páginas de contenido lo admiten, en ambos idiomas.

/es/weather?format=md — el pronóstico, en Markdown
/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_tropical_outlook, get_pollen, get_air_quality, get_river_levels, get_fishing, get_traffic, get_crosby_news, get_school_events, get_emergency_contacts y get_radar (una imagen de radar en vivo, en línea) — 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 — endpoint MCP (POST JSON-RPC) — el servidor funciona solo en inglés
/es/mcp — página explicativa en español (no es un endpoint: un POST aquí devuelve 404)
Tarjeta del servidor MCP — 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 — í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 — alertas activas del NWS (RSS 2.0; vacío cuando no hay ninguna)
/news.xml — titulares seleccionados del área de Crosby (RSS 2.0)

Insignia del clima para incrustar

Pon el clima de Crosby en vivo en tu propio sitio con una sola etiqueta de imagen — un SVG pequeño (300×80) con la temperatura actual, las condiciones, la sensación térmica y un indicador de alertas. Con caché en el borde y actualizado en el mismo ciclo de 15 minutos que todo lo demás; sin clave, sin scripts, CORS abierto. El texto de la insignia está en inglés.

/badge.svg — la insignia en vivo — incrústala con <img src="https://crosbynews.com/badge.svg" width="300" height="80" alt="Crosby, TX weather">

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.