Spaces:
Running
Running
| <html lang="es" data-root="../"> | |
| <head> | |
| <meta charset="utf-8"> | |
| <meta name="viewport" content="width=device-width, initial-scale=1"> | |
| <title>Conecta AMC a tu asistente · AMC</title> | |
| <meta name="description" content="Instala la extensión de Analíticas Mercantiles Colombianas en Claude Desktop, paso a paso y sin programar, para que tu asistente responda con los datos del registro mercantil de Colombia."> | |
| <meta property="og:title" content="Conecta AMC a tu asistente de IA"> | |
| <meta property="og:description" content="Una extensión para Claude Desktop: tu asistente busca empresas, ve su perfil y cuenta empresas con los datos abiertos de AMC. Paso a paso, sin programar."> | |
| <meta property="og:type" content="article"> | |
| <link rel="icon" href="../assets/favicon.svg" type="image/svg+xml"> | |
| <meta property="og:image" content="https://amc.clyxconsulting.com/assets/og/inicio.png"> | |
| <meta property="og:image:width" content="1200"> | |
| <meta property="og:image:height" content="630"> | |
| <meta property="og:site_name" content="Analíticas Mercantiles Colombianas"> | |
| <meta name="twitter:card" content="summary_large_image"> | |
| <meta name="twitter:image" content="https://amc.clyxconsulting.com/assets/og/inicio.png"> | |
| <link rel="preconnect" href="https://fonts.googleapis.com"> | |
| <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> | |
| <link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&family=Inter+Tight:wght@600;700;800&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet"> | |
| <link rel="stylesheet" href="../assets/amc.css"> | |
| <link rel="stylesheet" href="../assets/nav.css"> | |
| <style> | |
| .steps-howto { counter-reset: s; list-style: none; padding: 0; margin: 0 0 1.4em; } | |
| .steps-howto > li { counter-increment: s; position: relative; padding: 0 0 0 52px; margin: 0 0 1.3em; } | |
| .steps-howto > li::before { content: counter(s); position: absolute; left: 0; top: -2px; width: 36px; height: 36px; border-radius: 50%; | |
| background: var(--ink); color: var(--bg, #fff); font: 700 17px/36px "Inter Tight", sans-serif; text-align: center; } | |
| .steps-howto > li b:first-child { display: block; font-size: 18.5px; margin-bottom: 2px; } | |
| .get { display: flex; flex-wrap: wrap; gap: 12px; align-items: center; margin: 0 0 1.4em; } | |
| .get small { color: var(--muted); } | |
| .asks { list-style: none; padding: 0; margin: 0 0 1.2em; } | |
| .asks li { background: var(--surface-2); border: 1px solid var(--border); border-radius: 10px; padding: 10px 14px; margin: 0 0 8px; } | |
| .asistente pre { margin: 0 0 1.05em; background: var(--surface-2); border: 1px solid var(--border); border-radius: 10px; padding: 12px 14px; | |
| font: 13px/1.6 var(--mono); color: var(--ink); overflow: auto; white-space: pre; } | |
| .asistente code { font: .88em var(--mono); } | |
| .asistente pre code { font-size: 1em; } | |
| </style> | |
| <link rel="canonical" href="https://amc.clyxconsulting.com/asistente/"> | |
| <meta property="og:url" content="https://amc.clyxconsulting.com/asistente/"> | |
| <meta property="og:locale" content="es_CO"> | |
| <meta property="og:image:type" content="image/png"> | |
| <meta property="og:image:alt" content="Conecta AMC a tu asistente de IA"> | |
| </head> | |
| <body> | |
| <main class="wrap" id="app"><p class="loading">Cargando…</p></main> | |
| <noscript><p class="wrap">Esta página necesita JavaScript. La extensión se descarga en <a href="amc.mcpb">amc.mcpb</a>.</p></noscript> | |
| <script type="module"> | |
| import * as A from "../assets/amc.js"; | |
| const { el, rich } = A; | |
| A.chrome("asistente"); | |
| const app = document.getElementById("app"); | |
| // HOW TO CONNECT AMC TO AN ASSISTANT, for someone who has never installed | |
| // anything but apps (docs/ai-access-plan.md, step 2). The extension is | |
| // tools/amc-mcp, built into amc.mcpb beside this page: one file Claude Desktop | |
| // installs with a double click. Steps in the order they happen, what the | |
| // reader will see at each, and what to do when it does not go that way. | |
| const prose = (...blocks) => el("div", { class: "prose reveal" }, ...blocks.filter((b) => b != null).map((b) => | |
| b instanceof Node ? b : b.h2 ? el("h2", { text: b.h2 }) : Array.isArray(b) ? rich("p", {}, b) : el("p", { text: b }))); | |
| const step = (head, ...parts) => rich("li", {}, [{ b: head }, ...parts]); | |
| const code = (t) => el("code", { text: t }); | |
| try { | |
| const s = await A.summary(); | |
| // The extension's checksum, from the dataset's manifest on Hugging Face, | |
| // outside this site's host (ops/publish.py, F-14 of the security report). | |
| const ext = (await A.getJSON("manifest.json").catch(() => null))?.extension; | |
| app.replaceChildren( | |
| el("header", { class: "story-head" }, | |
| el("p", { class: "kicker", text: "Datos abiertos · IA" }), | |
| el("h1", { text: "Conecta AMC a tu asistente" }), | |
| el("p", { class: "dek", text: "Con esta extensión, Claude responde con los datos del registro mercantil de Colombia: busca una empresa, te muestra su perfil, cuenta cuántas hay de una actividad en una cámara de comercio, y cita la fuente. Se instala en cinco minutos, sin programar." })), | |
| el("div", { class: "asistente" }, prose( | |
| el("div", { class: "get" }, | |
| el("a", { class: "btn primary", href: "amc.mcpb", download: "amc.mcpb" }, "Descargar la extensión", A.icon("arrow")), | |
| el("small", { text: "amc.mcpb · para Claude Desktop en Mac, Windows o Linux · unos 9 MB" })), | |
| { h2: "Qué necesitas" }, | |
| ["La aplicación ", { b: "Claude Desktop" }, ", para computador, con tu cuenta de Claude. Si no la tienes, descárgala de ", | |
| { a: "claude.ai/download", href: "https://claude.ai/download" }, " e inicia sesión. Nada más: no hay que instalar programas ni escribir comandos."], | |
| ["La extensión funciona en la aplicación de computador, no en la página web de Claude ni en el teléfono. ¿Usas ChatGPT u otro asistente? Mira ", | |
| { a: "con otro asistente", href: "#otro" }, "."], | |
| { h2: "Cómo instalarla" }, | |
| el("ol", { class: "steps-howto" }, | |
| step("Descarga el archivo.", "Pulsa ", { b: "Descargar la extensión" }, ", arriba. Se guarda un archivo llamado ", code("amc.mcpb"), " en tu carpeta de Descargas."), | |
| step("Ábrelo con Claude.", "Abre Claude Desktop. Luego haz doble clic en ", code("amc.mcpb"), ". Si el doble clic no lo abre en Claude, entra en Claude a ", | |
| { b: "Configuración" }, " (Settings) → ", { b: "Extensiones" }, " (Extensions) y arrastra el archivo a esa ventana."), | |
| step("Confirma.", "Claude muestra la extensión, ", { b: "Analíticas Mercantiles Colombianas" }, ", con lo que puede hacer: buscar empresas, ver un perfil, contar empresas, describir las tablas y consultar con SQL. Pulsa ", | |
| { b: "Instalar" }, " (Install). Si te pregunta si confías en la extensión, es porque no viene del directorio de Claude: es de AMC, y su código va dentro del mismo archivo, con licencia MIT."), | |
| step("Comprueba que está activa.", "En ", { b: "Configuración → Extensiones" }, " debe aparecer AMC encendida. Si no aparece, cierra Claude del todo y vuelve a abrirlo."), | |
| step("Pregúntale.", "Abre una conversación nueva y pregunta algo de empresas colombianas; si quieres que use AMC, dilo: «usa AMC». La primera vez, Claude te pide permiso para usar la extensión: elige ", | |
| { b: "Permitir" }, " (Allow), una vez o siempre.")), | |
| { h2: "Qué puedes preguntarle" }, | |
| el("ul", { class: "asks" }, | |
| el("li", { text: "¿Alpina sigue activa? ¿Cuál es su NIT y cuánto vendió el último año? Usa AMC." }), | |
| el("li", { text: "¿Cuántas panaderías hay vivas en la cámara de comercio de Medellín, y cuántas se crearon cada año?" }), | |
| el("li", { text: "¿Qué contratos con el Estado tiene la empresa con NIT 890903938?" }), | |
| el("li", { text: "¿Cuántas empresas de software se crearon en Colombia desde 2020?" }), | |
| el("li", { text: "Con AMC, haz una consulta SQL: las 10 actividades con más empresas vivas." })), | |
| ["Claude responde con las cifras, el corte de los datos (la fecha del registro que usa) y un enlace a la página de la empresa o de la actividad en AMC, para que las verifiques."], | |
| { h2: "Lo que conviene saber" }, | |
| el("ul", {}, | |
| rich("li", {}, [{ b: "«Viva» no es «activa». " }, "AMC cuenta como viva la empresa que renovó su matrícula este año; el registro marca como «ACTIVA» a más del doble. ", | |
| { a: "Por qué", href: "../metodologia/index.html#activa" }, "."]), | |
| rich("li", {}, [{ b: "Las personas naturales se cuentan, nunca se nombran" }, " (Ley 1581 de 2012): un comerciante persona natural no aparece por su nombre ni por su cédula."]), | |
| rich("li", {}, [{ b: "La geografía es la cámara de comercio" }, ", no el municipio: el registro abierto no trae municipio."]), | |
| rich("li", {}, [{ b: "La primera pregunta tarda unos segundos" }, ", mientras la extensión trae lo que necesita de los datos; las siguientes son más rápidas. Necesita internet."])), | |
| { h2: "Tu privacidad" }, | |
| ["La extensión corre en tu computador. Lee solo los archivos que AMC publica en Hugging Face, nunca tus archivos, y a Hugging Face solo le pide las partes de los archivos que necesita: tus preguntas no salen de tu computador hacia AMC ni hacia nadie más que tu asistente. AMC no recibe nada de lo que preguntas. ", | |
| { a: "Política de datos", href: "../privacidad/index.html" }, "."], | |
| ...(ext ? [ | |
| { h2: "Comprueba que el archivo es el original" }, | |
| ["Cada noche publicamos la huella SHA-256 de ", code("amc.mcpb"), " en el ", { a: "manifiesto de los datos", href: `${A.HF}/blob/main/manifest.json` }, | |
| ", en Hugging Face, fuera del servidor de este sitio (búscala en ", code("extension"), "). Es esta:"], | |
| el("p", {}, el("code", { style: "overflow-wrap:anywhere;hyphens:none;-webkit-hyphens:none", text: ext.sha256 })), | |
| ["Calcula la del archivo que descargaste. En Mac o Linux, en la Terminal: ", code("shasum -a 256 ~/Downloads/amc.mcpb"), | |
| ". En Windows, en PowerShell: ", code("Get-FileHash $HOME\\Downloads\\amc.mcpb"), ". Si no coinciden, no la instales y escríbenos."], | |
| ] : []), | |
| { h2: "Si algo no funciona" }, | |
| el("ul", {}, | |
| rich("li", {}, [{ b: "El doble clic abre otra cosa o nada." }, " Usa el otro camino: en Claude, Configuración → Extensiones, y arrastra el archivo a esa ventana."]), | |
| rich("li", {}, [{ b: "Claude no usa la extensión." }, " Revisa que esté encendida en Configuración → Extensiones, y pídeselo de forma explícita: «usa la extensión de AMC»."]), | |
| rich("li", {}, [{ b: "Dice que no pudo responder." }, " Puede ser la conexión a internet o que Hugging Face no responda en ese momento: inténtalo de nuevo en un minuto."]), | |
| rich("li", {}, [{ b: "Para actualizarla" }, ", descarga el archivo otra vez desde esta página e instálalo encima. ", { b: "Para quitarla" }, ", Configuración → Extensiones → AMC → Desinstalar."]), | |
| rich("li", {}, ["¿Otra duda? Escríbenos a ", { a: "clyx.consulting@gmail.com", href: "mailto:clyx.consulting@gmail.com" }, "."])), | |
| // Other assistants: no hosted connector (docs/ai-access-plan.md, steps 3 and 4, dropped). | |
| el("h2", { id: "otro", text: "Con otro asistente" }), | |
| ["ChatGPT, y Claude en la web o en el teléfono, no instalan extensiones, y por ahora AMC no tiene un conector en internet para ellos. Aun así, hay dos caminos:"], | |
| el("ul", {}, | |
| rich("li", {}, [{ b: "Dale a tu asistente la guía de AMC. " }, "Si puede leer páginas web, pídele que lea ", code("https://amc.clyxconsulting.com/llms.txt"), | |
| " antes de responder. Ahí está dónde están los datos, qué significa cada tabla y qué cuidar al citarlos; con eso te explica los datos y te escribe la consulta SQL que necesitas."]), | |
| rich("li", {}, [{ b: "Pregúntale al sitio. " }, "La ", { a: "consulta SQL", href: "../consulta/index.html" }, " corre esa consulta en tu navegador, sin instalar nada; ", | |
| { a: "Busca tu empresa", href: "../historias/tu-empresa/index.html" }, " y el ", { a: "explorador", href: "../explorar/index.html" }, " responden lo más común sin SQL."])), | |
| { h2: "Para programadores" }, | |
| ["Es un servidor MCP (Model Context Protocol). El archivo ", code("amc.mcpb"), " es un zip: descomprímelo y apunta tu cliente MCP (Claude Code, Cursor, VS Code…) a ", code("server/index.cjs"), " con Node 18 o más:"], | |
| el("pre", { tabindex: "0" }, el("code", { text: `{\n "mcpServers": {\n "amc": { "command": "node", "args": ["/ruta/a/amc/server/index.cjs"] }\n }\n}` })), | |
| ["Herramientas: ", code("buscar_empresa"), ", ", code("perfil_empresa"), ", ", code("contar_empresas"), ", ", code("describir_tablas"), " y ", code("consultar_sql"), | |
| ". Usa DuckDB-WASM sobre los archivos publicados, sin nada compilado, y no lee archivos locales. Sin la extensión, los datos también se consultan directamente: ", | |
| { a: "Datos y acceso para IA", href: "../datos/index.html" }, "."]))); | |
| A.reveal(app); | |
| A.footer(s); | |
| window.__amcReady = true; | |
| } catch (e) { A.fail(app, e, "la página"); } | |
| </script> | |
| </body> | |
| </html> | |