# 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/fishing](/api/fishing) — condiciones del agua del USGS (temp, oxígeno disuelto, pH, turbidez) para aguas de pesca cercanas
- [/api/tropics](/api/tropics) — ciclones tropicales activos del Atlántico según el NHC de NOAA, además de zonas sin nombre bajo vigilancia y sus probabilidades de formación
- [/api/pollen](/api/pollen) — el conteo diario medido de polen y moho del Departamento de Salud de Houston (mañanas entre semana)
- [/api/burn-ban](/api/burn-ban) — el estado actual de la prohibición de quemas al aire libre del condado de Harris, según el Servicio Forestal de Texas A&M (solo a nivel de condado)
- [/api/air](/api/air) — el AQI medido de EE. UU. (EPA/AirNow, área metropolitana de Houston) con desglose por contaminante
- [/api/traffic](/api/traffic) — incidentes y cierres de carriles en los caminos de Crosby, según Houston TranStar
- [/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) — 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](/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. Todas las páginas de contenido lo admiten, en ambos idiomas.

- [/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_tropical_outlook, get_pollen, get_burn_ban, 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](/mcp) — endpoint MCP (POST JSON-RPC) — el servidor funciona solo en inglés
- [/es/mcp](/es/mcp) — página explicativa en español (no es un endpoint: un POST aquí devuelve 404)
- [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)

## 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](/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.

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