title .........

Agentplace para desarrolladores y agentes

description ...

API pública, servidor MCP y agente A2A de Agentplace: buscá productos de 14 tiendas argentinas y leé su grafo de producto. Sin registro ni claves.

canonical .....

https://agentplace.crossup.ai/developers

updated .......

2026-10-01

# Agentplace para desarrolladores y agentes

-**API:** `https://agentplace.crossup.ai/api/v1`

-**OpenAPI:** [/openapi.json](https://agentplace.crossup.ai/openapi.json) (3.1)

-**MCP:** `https://agentplace.crossup.ai/mcp` (Streamable HTTP)

-**A2A:** `https://agentplace.crossup.ai/a2a` · [agent card](https://agentplace.crossup.ai/.well-known/agent-card.json)

-**Auth:** No hace falta ([auth.md](https://agentplace.crossup.ai/auth.md))

-**Contacto:** [hola@crossup.ai](mailto:hola@crossup.ai)

Todo Agentplace se lee por máquina: una API pública, un servidor MCP, un agente A2A y el Storegraph abierto. Catálogos de catorce tiendas argentinas con precio, stock y el vecindario de cada producto, listos para que tu agente busque, compare y recomiende como un buen vendedor. Sin registro y sin claves.

──Empezá en 30 segundos

Tres pedidos alcanzan para entender el modelo: buscar en todas las tiendas, abrir un producto con su vecindario en el grafo y listar las tiendas. Las respuestas son JSON; los precios están en la moneda de cada tienda (`ARS` hoy).

```bash

# Buscar en todas las tiendas, sólo con stock

curl -s "https://agentplace.crossup.ai/api/v1/products?q=aceite%20de%20limpieza&in_stock=true"

# Un producto con su vecindario: complementos, sets, un paso más, alternativas

curl -s "https://agentplace.crossup.ai/api/v1/products/kosmos/196162638"

# Las tiendas, con su cobertura del grafo

curl -s "https://agentplace.crossup.ai/api/v1/stores"

```

¿Preferís MCP? Sumá Agentplace a Claude Code con `claude mcp add --transport http agentplace https://agentplace.crossup.ai/mcp` y preguntale por un producto.

──API REST

Base `https://agentplace.crossup.ai/api/v1`. Sólo lectura (`GET` y `HEAD`), JSON, CORS abierto (`Access-Control-Allow-Origin: *`) y sin autenticación. La descripción completa, con cada campo, está en [OpenAPI 3.1](https://agentplace.crossup.ai/openapi.json); el catálogo de APIs del dominio, en [/.well-known/api-catalog](https://agentplace.crossup.ai/.well-known/api-catalog) (RFC 9727).

| Pedido | Qué devuelve |

| --- | --- |

| `GET /api/v1/stores` | Las tiendas: nombre, rubro, país, moneda, sitio, cantidad de productos y cobertura del grafo. |

| `GET /api/v1/stores/{store}` | Una tienda con sus categorías. |

| `GET /api/v1/products` | Búsqueda y listado en todas las tiendas, con filtros y paginación (ver abajo). |

| `GET /api/v1/products/{store}/{id}` | Un producto (por id numérico de Tiendanube o por handle) con variantes, imágenes y su vecindario en el grafo. |

| `GET /api/v1/graph` | El manifiesto del Storegraph: tiendas, archivos y cuántos nodos, relaciones y sets tiene cada una. |

| `GET /api/v1/graph/{store}` | El grafo de una tienda en JSON: nodos, relaciones y sets. |

| `GET /api/v1/status` | Estado del servicio y fecha de los datos. |

──Buscar y filtrar productos

| Parámetro | Qué hace |

| --- | --- |

| `q` | Texto libre; no distingue mayúsculas ni tildes (`colchon` encuentra *colchón*). |

| `store` | Id de tienda (`kosmos`, `ganga-home`, …). |

| `department` | Departamento del marketplace (`belleza`, `hogar-y-deco`, `descanso`, …). |

| `category` | Slug de categoría de la tienda (va con `store`). |

| `min_price` · `max_price` | Rango de precio, en la moneda de la tienda. |

| `on_sale` · `in_stock` · `free_shipping` | `true` para quedarte sólo con ofertas, con stock o con envío gratis. |

| `sort` | `relevance` (por defecto), `price_asc`, `price_desc` o `discount`. |

| `page` · `per_page` | Paginación; la respuesta trae el total y los links a la página siguiente y anterior. |

──El vecindario de un producto

`GET /api/v1/products/{store}/{id}` devuelve el producto y lo que lo rodea en el grafo. Cada vecino trae su `relation` y el `reason` en lenguaje natural, el mismo que muestra la página. Sólo aparecen relaciones que pasaron los umbrales de calidad: un bloque vacío significa que no hay una recomendación confiable, no que falten datos.

| Bloque | Qué significa |

| --- | --- |

| `complements` | Se usan juntos: lo que conviene sumar. |

| `sets` | Kits y rutinas que la tienda vende o que el grafo arma con productos que van juntos. |

| `step_up` | Un paso más: la versión superior o el mismo producto en pack. |

| `alternatives` | Otra opción para la misma necesidad; con el producto sin stock, primero las que sí tienen. |

| `other_versions` | El mismo producto en otro color, talle o presentación. |

Cada producto trae además `url` (su página en Agentplace), `markdown_url` (la misma página en markdown) y `buy_url`, el link para comprar.

──Para comprar: buy_url

`buy_url` apunta a `/go/<tienda>/<id>` y redirige a la página del producto en la tienda, con atribución `utm` (y `?via=api`, `mcp`, `a2a`, `webmcp` o `ucp` según desde dónde lo pediste). La compra, el pago y el envío los hace la tienda en su propio checkout: la API no crea carritos ni cobra.

──Servidor MCP

`https://agentplace.crossup.ai/mcp` es un servidor [Model Context Protocol](https://modelcontextprotocol.io) remoto: Streamable HTTP, sin estado y sin autenticación. Su tarjeta está en [/.well-known/mcp/server-card.json](https://agentplace.crossup.ai/.well-known/mcp/server-card.json).

| Tool | Para qué |

| --- | --- |

| `search_products` | Buscar en todas las tiendas con texto y filtros (tienda, departamento, precio, ofertas, stock). |

| `get_product` | Un producto con variantes, stock y su vecindario en el grafo, con el motivo de cada relación. |

| `list_stores` | Las tiendas, su rubro y cuántos productos tienen. |

| `get_storegraph` | El grafo de una tienda: tamaño, sets y el archivo completo; o las relaciones de un producto. |

| `get_buy_link` | El link para comprar un producto en su tienda (no arma carritos). |

```bash

# Claude Code

claude mcp add --transport http agentplace https://agentplace.crossup.ai/mcp

# Probarlo con el inspector oficial (elegí "Streamable HTTP" y pegá la URL)

npx @modelcontextprotocol/inspector

```

```jsonc

// Cursor: ~/.cursor/mcp.json

{

"mcpServers": {

"agentplace": { "url": "https://agentplace.crossup.ai/mcp" }

}

}

```

En claude.ai: *Settings → Connectors → Add custom connector* y pegá `https://agentplace.crossup.ai/mcp`.

──Agente A2A

Agentplace también es un agente [A2A](https://a2a-protocol.org): otros agentes le hablan por JSON-RPC en `https://agentplace.crossup.ai/a2a` y les responde qué productos convienen, con su vecindario y el link de compra. Responde con datos del catálogo y del grafo, nunca crea carritos ni pagos. Su [agent card](https://agentplace.crossup.ai/.well-known/agent-card.json) describe las skills y la versión del protocolo.

```bash

curl -s https://agentplace.crossup.ai/a2a \

-H 'Content-Type: application/json' \

-d '{"jsonrpc":"2.0","id":1,"method":"message/send","params":{"message":{"role":"user","messageId":"m1","parts":[{"kind":"text","text":"aceite de limpieza facial con stock"}]}}}'

```

──Universal Commerce Protocol (UCP)

Para plataformas que hablan [UCP](https://ucp.dev) (2026-08-25): el [perfil](https://agentplace.crossup.ai/.well-known/ucp) declara la capacidad de catálogo (`dev.ucp.shopping.catalog.search` y `.lookup`) sobre REST en `https://agentplace.crossup.ai/ucp/v1`. Cada variante trae su `seller` (la tienda que vende), precio en unidades menores (centavos de ARS) y un `url` que la abre en la tienda. No hay checkout UCP: la compra es en la tienda de cada marca.

```bash

curl -s -X POST https://agentplace.crossup.ai/ucp/v1/catalog/search \

-H 'Content-Type: application/json' \

-H 'UCP-Agent: profile="https://tu-plataforma.example/.well-known/ucp"' \

-d '{"query":"sábanas 2 plazas","filters":{"price":{"max":6000000}},"pagination":{"limit":5}}'

```

──En el navegador: WebMCP

Cada página de Agentplace registra sus tools en `navigator.modelContext` cuando el navegador lo soporta: un agente que navega el sitio puede buscar productos, leer el producto que está viendo y pedir el link de compra sin tocar el DOM.

──Descubrimiento

| Archivo | Qué es |

| --- | --- |

| [/llms.txt](https://agentplace.crossup.ai/llms.txt) | Índice para modelos: cuándo usar Agentplace, tiendas y links. |

| [/openapi.json](https://agentplace.crossup.ai/openapi.json) | OpenAPI 3.1 de la API. |

| [/.well-known/api-catalog](https://agentplace.crossup.ai/.well-known/api-catalog) | Catálogo de APIs (RFC 9727). |

| [/.well-known/mcp/server-card.json](https://agentplace.crossup.ai/.well-known/mcp/server-card.json) | Tarjeta del servidor MCP. |

| [/.well-known/agent-card.json](https://agentplace.crossup.ai/.well-known/agent-card.json) | Agent card A2A. |

| [/.well-known/agent-skills/index.json](https://agentplace.crossup.ai/.well-known/agent-skills/index.json) | Agent Skills con su digest. |

| [/.well-known/ai-catalog.json](https://agentplace.crossup.ai/.well-known/ai-catalog.json) | Catálogo de recursos para agentes (ARD). |

| [/.well-known/storegraph](https://agentplace.crossup.ai/.well-known/storegraph) | Manifiesto del Storegraph 0.1; los grafos por tienda están en `/storegraph/<tienda>.jsonl` y se exploran en `/grafo/<tienda>`. |

| [/.well-known/ucp](https://agentplace.crossup.ai/.well-known/ucp) | Perfil UCP: catálogo (búsqueda y lookup), sin checkout. |

| [/auth.md](https://agentplace.crossup.ai/auth.md) | Cómo autenticarse: no hace falta. |

| [/sitemap.xml](https://agentplace.crossup.ai/sitemap.xml) | Sitemap de todas las páginas. |

Toda página tiene su versión markdown: agregá `.md` a la URL (la home es `/index.md`) o pedila con `Accept: text/markdown`.

──Límites, caché y versiones

-**Límites.** `/api/v1/products` acepta 120 pedidos por minuto por IP (por instancia del servidor). Cada respuesta trae `RateLimit-Policy` y `RateLimit` (IETF); un `429` suma `Retry-After`. Tiendas y grafo salen de la caché del CDN y no tienen límite.

-**Caché.** Cada respuesta dice cuánto se puede cachear en `Cache-Control`. Los datos se actualizan una vez por día; `GET /api/v1/status` dice de cuándo son.

-**Versiones.** La ruta lleva la versión mayor (`/api/v1`). Un cambio incompatible sale en `/api/v2`; antes de retirar algo lo anunciamos con los encabezados `Deprecation` y `Sunset` y en esta página.

-**Descripción en cada respuesta.** Toda respuesta de la API trae `Link` a la descripción (`rel="service-desc"`, `/openapi.json`) y a esta documentación (`rel="service-doc"`).

──Errores

Los errores de la API, del servidor MCP y del agente A2A usan RFC 9457 (`application/problem+json`): `type` apunta a la sección de abajo, y el cuerpo trae `title`, `status`, `detail`, `code` (por ejemplo `rate_limited`), `hint` con qué hacer y `instance` con la ruta del pedido.

──invalid-parameter · 400

Un parámetro no tiene el formato esperado (por ejemplo `min_price=barato`). `detail` dice cuál; corregilo y repetí el pedido.

──store-not-found · 404

No hay una tienda con ese id. La lista completa está en `GET /api/v1/stores`.

──product-not-found · 404

La tienda existe pero no tiene ese producto publicado hoy. Buscalo de nuevo con `GET /api/v1/products?q=…&store=…`.

──not-found · 404

La ruta no existe en la API. Revisá la ruta contra `/openapi.json`.

──method-not-allowed · 405

La API es de lectura: usá `GET` (o `HEAD`). El encabezado `Allow` dice qué métodos acepta la ruta.

──rate-limited · 429

Pasaste el límite de pedidos por minuto. Esperá los segundos que indica `Retry-After` y seguí.

──not-acceptable · 406

El encabezado `Accept` excluye JSON. Pedí `application/json` (o `*/*`).

──internal-error · 500

Algo falló de nuestro lado. Reintentá en unos segundos; si se repite, escribinos con el `instance` de la respuesta.

──Uso y atribución

Todo es gratis y de lectura. Pedimos citar a Agentplace y a la tienda cuando muestres sus datos, y mandar a comprar con `buy_url`. Detalle en los [términos de uso](https://agentplace.crossup.ai/terminos); qué medimos, en la [política de privacidad](https://agentplace.crossup.ai/privacidad). Para dudas, ideas o más volumen: [hola@crossup.ai](mailto:hola@crossup.ai).