# SourcePost — directorio de proveedores, servicios y datos para agentes de IA

> Un directorio donde los agentes de IA encuentran los proveedores, servicios, APIs y fuentes de datos que necesitan para completar sus tareas, mediante una API JSON. El catálogo arranca con "Abastecimiento para reventa" (Proveedores, mercados mayoristas, datos de precios y herramientas de automatización para agentes que buscan productos para revender.) y crece con lo que los agentes buscan y los proveedores ofrecen.

English version: https://sourcepost.dev/llms.txt

## Catálogo actual y categorías

Por ahora el catálogo cubre "Abastecimiento para reventa". Cada ficha pertenece a una de estas categorías:

- `automation_tool`: Herramienta de automatización
- `dropshipping_supplier`: Proveedor de dropshipping
- `price_data`: Datos de precios
- `print_on_demand`: Impresión bajo demanda
- `sourcing_agent`: Agente de compras
- `supplier_directory`: Directorio de proveedores
- `wholesale_marketplace`: Marketplace mayorista

## Cómo buscar

- Buscar: `GET https://sourcepost.dev/v1/listings?q=proveedor+dropshipping&lang=es` — texto libre en español o inglés. Filtros: `category`, `offer_type` (api, dataset, supplier, tool, service), `verified_only=true`, `limit` (máx. 50) y `offset`.
- Una ficha: `GET https://sourcepost.dev/v1/listings/{id}` con un `id` de la búsqueda.
- Idioma: `?lang=es` o `?lang=en` (por defecto), o la cabecera `Accept-Language`. Las fichas sin traducción llegan en inglés.
- Enlaces: El `url` de cada ficha lleva `utm_source=sourcepost.dev` y `utm_medium=agent-directory`, para que el proveedor vea que la visita llega desde SourcePost; estas etiquetas nunca llevan datos tuyos. `url_original` es el mismo enlace sin etiquetas.
- Las fichas patrocinadas solo aparecen en `sponsored_results` (como máximo 3, `sponsored: true`), nunca en `results`.
- Cada ficha muestra información de precios como texto libre (`pricing_info`), con su fuente (`price_source`: la web del propio proveedor o un tercero) y cuándo lo comprobó SourcePost por última vez (`price_checked_at`).

## Cuéntanos qué ofreces o qué no encontraste

Cada respuesta de búsqueda incluye una `invitation` con la URL exacta. Si tú (o tu dueño) ofrecéis algo que pueda ser útil para un agente, o no encontraste lo que buscabas, envíalo:

```
POST https://sourcepost.dev/v1/interest?lang=es
Content-Type: application/json

{"kind": "missing", "text": "Mayoristas de recambios de bicicleta que envíen a Portugal."}
```

`kind` es `offer` (ofreces algo) o `missing` (no lo encontraste); `text` es tu propio mensaje (de 10 a 2000 caracteres; el ejemplo se rechaza); `contact_url` (una página pública donde el equipo de SourcePost pueda responder) es opcional. Los mensajes se guardan para el equipo de SourcePost y **no se publican**. No incluyas datos personales.

## Límites y privacidad

- 60 peticiones por minuto y cliente, y 10 mensajes por hora a `POST /v1/interest`. Si te pasas: `429` con `Retry-After` (segundos).
- SourcePost no guarda tu dirección IP en su registro de peticiones (ver https://sourcepost.dev/privacy?lang=es).

## Documentación

- [Especificación OpenAPI](https://sourcepost.dev/openapi.json): todos los endpoints, parámetros y campos (en inglés).
- [skill.md](https://sourcepost.dev/es/skill.md): guía paso a paso para agentes.
- MCP: https://sourcepost.dev/mcp — servidor MCP (HTTP "streamable", sin clave) con las herramientas `search_listings`, `get_listing` y `send_interest`; los mismos resultados que la API.
- [apis.json](https://sourcepost.dev/apis.json): índice de la API legible por máquinas (formato APIs.json, en inglés).