Ejemplos de código
Clientes listos para copiar y pegar para ambos transportes del contrato de lectura de Tarno. Reemplaza la
clave de marcador <API_KEY> con tu clave emitida por el operador en tiempo de ejecución — nunca subas una
clave real.
REST
curl
export TARNO_API_KEY="<API_KEY>"
# Buscar/listar resúmenes de marcas (página keyset)
curl -sS "https://api.tarno.cl/trademarks?q=cafe&limit=5" \
-H "X-API-Key: $TARNO_API_KEY"
# Detalle completo de una solicitud, con secciones expandidas (`norms` exige además `legal:read`)
curl -sS "https://api.tarno.cl/trademarks/123456?expand=parties,annotations,encumbrances,classes,norms" \
-H "X-API-Key: $TARNO_API_KEY"
# Lote: varias solicitudes conocidas, de una vez (hasta 100)
curl -sS "https://api.tarno.cl/trademarks?applicationNumber=1286842,823470,9999999" \
-H "X-API-Key: $TARNO_API_KEY"
TypeScript (fetch)
const baseUrl = "https://api.tarno.cl";
const apiKey = process.env.TARNO_API_KEY!; // "<API_KEY>"
async function listTrademarks(q: string, limit = 20) {
const url = new URL(`${baseUrl}/trademarks`);
url.searchParams.set("q", q);
url.searchParams.set("limit", String(limit));
const res = await fetch(url, { headers: { "X-API-Key": apiKey } });
if (!res.ok) {
const problem = await res.json(); // application/problem+json (RFC 9457)
throw new Error(`${problem.status} ${problem.code}: ${problem.detail}`);
}
// { results: Trademark[], limit, next, hasMore, total, meta }
return res.json() as Promise<{ results: unknown[]; next: string | null }>;
}
const page = await listTrademarks("cafe", 5);
console.log(page.results.length, "results; next =", page.next);
MCP
Un cliente mínimo de @modelcontextprotocol/sdk que se conecta al endpoint Streamable HTTP con el
encabezado X-API-Key y llama a las herramientas.
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const url = process.env.MCP_URL ?? "https://mcp.tarno.cl";
const apiKey = process.env.TARNO_API_KEY!; // "<API_KEY>"
const transport = new StreamableHTTPClientTransport(new URL(url), {
requestInit: { headers: { "X-API-Key": apiKey } },
});
const client = new Client({ name: "tarno-mcp-example", version: "1.0.0" });
await client.connect(transport); // handshake JSON-RPC initialize
try {
// search_trademarks — misma entrada/salida que GET /trademarks
const search = await client.callTool({
name: "search_trademarks",
arguments: { q: "cafe", limit: 5 },
});
const firstText = (r: typeof search) =>
(r.content as Array<{ type: string; text?: string }>).find((c) => c.type === "text")?.text;
const page = JSON.parse(firstText(search) ?? "{}");
console.log(page.results.length, "results; next =", page.next);
// get_trademark — misma entrada/salida que GET /trademarks/{applicationNumber}
const detail = await client.callTool({
name: "get_trademark",
arguments: { applicationNumber: "123456", expand: ["parties", "annotations"] },
});
console.log(firstText(detail)); // JSON del detalle
} finally {
await client.close();
}
Ambas herramientas requieren el scope
brands:read(o una clave sin restricción). Una clave ausente o inválida devuelve un resultado de error — nunca datos del corpus. Consulta la guía de MCP y la guía de autenticación.
Ver también
- Primeros pasos — puesta en marcha de REST, sobre y paginación.
- Conecta tu agente de IA (MCP) — endpoint, herramientas, configuración de cliente.
- La referencia OpenAPI en vivo en
https://api.tarno.cl/docs— el esquema REST autoritativo.