Agregar prospectos desde fuera de la app

Cualquier cosa fuera de Artisanly puede agregar a tu lista de prospectos con una clave de API con alcance de Prospectos, creada en Configuración → Claves de API. El caso para el que se construyó es una IA en tu propio escritorio: le pides las cafeterías de una ciudad a la que nadie ha llamado y las mete directo en Prospectos, con una nota en cada una que dice por qué vale la pena visitarla.

Lo que llega siempre es un prospecto que nadie tiene. Nada fuera de la app puede afirmar que una tienda aceptó venderte, y una tienda que encontró un agente no ha sido tomada por ningún vendedor: alguien la toma de la lista, y ese es el momento en que pasa a ser suya.

Cada carga queda registrada como un lote, listado en Prospectos → Cargas con lo que entró, lo que ya estaba y lo que se rechazó. Un agente a veces se equivoca, así que quitar un lote es una sola acción y no una tarde entera: borra las tiendas que nadie ha tomado y conserva todo lo que alguien ya recogió.

Una tienda que ya está en tus libros regresa como duplicada en vez de como error, así que un agente al que le preguntas lo mismo dos veces no puede crearla dos veces. Las ciudades se identifican por nombre contra tus regiones, y un nombre que no usas es la única razón por la que se rechaza una fila — por eso la integración lee primero tu lista de regiones.

La configuración está en el repositorio, en tools/prospect-mcp, para Claude en un escritorio, y la guía completa para cualquier otra cosa está en /docs/prospects-api.md.