Listings API

Listings API es una API local de citaciones y envío de listados: una sola llamada REST envía un negocio a más de 50 sitios de listados, incluidos Google Business Profile, Apple Maps, Bing Places, Facebook, Yelp y el resto de los principales directorios, mapas y motores de respuesta, y mantiene su nombre, dirección, teléfono y horarios sincronizados en todos los lugares donde aparece. Administre ubicaciones de negocios, listados, reseñas, publicaciones y análisis locales. Supervise el estado de los listados, responda a reseñas, publique publicaciones y analice el rendimiento. DayPass es gratuito cuando está disponible: activación de 24 horas, sin tarjeta de crédito, 2 ubicaciones y 10 directorios de demostración. DayPass solo admite ubicaciones y listados, sin escrituras reales en editores, reseñas, publicaciones ni análisis. Sitio web: https://www.listingsapi.com/ Endpoint MCP: https://listingsapi.com/mcp Guía de DayPass: https://listingsapi.com/docs/day-pass.md Registro de DayPass: https://listingsapi.com/signup?plan=day-pass&campaign=daypass Repositorio: https://github.com/listings-api/listingsapi-mcp

GitHubPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://listingsapi.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Listings API MCP

Conecta cualquier asistente de IA compatible con MCP a la Listings API y gestiona fichas de negocio, reseñas, publicaciones y analíticas locales en más de 50 directorios, mapas y motores de búsqueda.

Sitio web · Documentación de la API · Página de MCP · Obtén una clave de API · Actores de Apify

Qué es la Listings API

La búsqueda local funciona con datos de negocio. Una tienda, una clínica o una franquicia tiene un nombre, una dirección, un número de teléfono, horarios de apertura, categorías y fotos, y esos datos deben ser idénticos en Google, Apple Maps, Bing, Facebook, Yelp, los asistentes de voz y docenas de directorios más pequeños antes de que los motores de búsqueda confíen lo suficiente como para posicionarlos. Mantener esos datos consistentes a mano no escala más allá de un puñado de ubicaciones.

La Listings API es una API REST que hace este trabajo. Almacenas cada ubicación una sola vez, y la API la sincroniza con más de 50 editores, rastrea dónde está activa cada ficha, encuentra y suprime duplicados, recopila las reseñas que esas fichas recogen, te permite responderlas, publica publicaciones y ofertas en los perfiles conectados, y devuelve los datos de rendimiento que Google, Facebook y Bing reportan. Las agencias, las marcas con múltiples ubicaciones y los sistemas de franquicias la usan para gestionar la presencia local de cientos o miles de ubicaciones desde un solo lugar.

Qué es este servidor MCP

El Model Context Protocol permite que un asistente de IA llame a herramientas externas. Este servidor expone la Listings API como un conjunto de herramientas MCP, de modo que un asistente como Claude, Cursor, Windsurf, Gemini CLI o Cline pueda consultar tus ubicaciones, leer tus reseñas, redactar y publicar respuestas, programar publicaciones y obtener analíticas en conversación natural, usando tu propia cuenta y tus propios datos.

Es un servidor remoto. Se ejecuta en https://listingsapi.com/mcp y usa Streamable HTTP. No se requiere ningún paquete local ni compilación. Apunta tu cliente a la URL e inicia sesión mediante su flujo OAuth en el navegador, o usa una clave de API existente donde el cliente requiera una cabecera.

https://listingsapi.com/mcp

Qué puedes hacer con él

Una vez conectado, el asistente puede trabajar en cinco áreas de tu cuenta.

Ubicaciones. Crea y actualiza perfiles de ubicación, busca ubicaciones y lee sus detalles. Una ubicación es el registro maestro que usan las fichas de sus editores.

Fichas y citaciones. Consulta qué editores tienen actualmente una ubicación y en qué estado está cada ficha, lista los sitios que cubre tu plan, obtén las fichas duplicadas que la red ha detectado para una ubicación o para toda tu cuenta, y marca una ficha como duplicada para que se suprima, o borra esa marca si la coincidencia fue incorrecta. La cobertura de asistentes de voz se reporta por separado.

Reseñas. Lee reseñas, obtén reseñas específicas por ID, inspecciona las analíticas de reseñas y publica respuestas donde el editor conectado lo permita. Las respuestas publicadas aparecen en el sitio de reseñas.

Publicaciones. Lee publicaciones existentes y publica nuevas en los perfiles conectados compatibles. Consulta el contrato de herramientas actual para conocer los editores y cargas útiles compatibles.

Analíticas. Lee el rendimiento de Google, Facebook y Bing para cualquier ubicación: vistas de búsqueda, vistas de mapa, solicitudes de indicaciones, llamadas, clics en el sitio web y el resto, para el rango de fechas que pidas.

También hay un conjunto de operaciones de cuentas conectadas para vincular una cuenta de Google o Facebook, emparejar sus perfiles con tus ubicaciones y crear una ficha de Google Business Profile completamente nueva para una ubicación que no tenga ninguna.

Las operaciones destructivas, como archivar ubicaciones y eliminar publicaciones, no se exponen como herramientas MCP. Usa la guía de MCP y las herramientas de documentación del servidor para consultar las operaciones disponibles actualmente.

Ejemplos de solicitudes

Una vez que el servidor esté conectado, estas son las cosas que puedes pedirle a tu asistente.

"Lista todas las ubicaciones que tenemos en Texas y dime cuáles no tienen número de teléfono."
"Muéstrame todas las reseñas de menos de tres estrellas de la última semana en todas las tiendas, agrupadas por ubicación."
"Redacta una respuesta a la última reseña de Google de la tienda de Austin, mantenla en menos de 60 palabras y publícala."
"Publica una oferta de 20 por ciento de descuento en servicio para todas las ubicaciones de la región noreste, vigente hasta fin de mes."
"Compara las solicitudes de indicaciones y las llamadas de nuestras diez mejores tiendas este mes frente al mes pasado."
"¿Cuáles de nuestras ubicaciones aún no tienen una ficha de Google Business Profile?"

Qué necesitas

Una cuenta de ListingsAPI. Consulta planes y registro para acceso de producción, o revisa la disponibilidad del Day Pass más abajo. Los clientes compatibles con OAuth te permiten iniciar sesión sin copiar una clave de API en un archivo de configuración.

Pruébalo gratis con un pase de un día

Consulta la disponibilidad en vivo antes de registrarte; el Day Pass se ofrece por períodos limitados. Mientras open sea verdadero, puedes activar un sandbox gratuito de 24 horas en registro del Day Pass. Cubre hasta 2 ubicaciones y sincroniza con 10 directorios de demostración de ListingsAPI. Nunca escribe en editores reales. Las reseñas, publicaciones, redes sociales, analíticas, cuentas conectadas y webhooks están excluidas.

El registro pide tu nombre, correo electrónico y empresa, además de la aceptación de los Términos de Servicio y la Política de Privacidad. Las 24 horas comienzan cuando activas el pase mediante el enlace enviado por correo o el código de 6 dígitos. Lee la guía del Day Pass para conocer los límites actuales y los pasos de activación. En un cliente OAuth, elige Envíame un enlace de inicio de sesión con el correo del Day Pass. Para clientes con clave de API, configura la clave del Day Pass localmente usando el mismo prefijo de cabecera API. Instalar un plugin o una skill no inicia un pase.

Las claves tienen un nivel de acceso. Una clave con acceso de Lectura cubre todas las consultas e informes. Crear y actualizar ubicaciones, responder reseñas, publicar publicaciones y conectar cuentas requiere una clave con acceso de Escritura.

El servidor acepta dos formas de autenticación:

Método	Cabecera	Úsalo cuando
OAuth 2.0	Gestionada por tu cliente	Tu cliente admite el flujo de inicio de sesión y consentimiento en el navegador
Clave de API	`Authorization: API <your-key>`	Tu cliente requiere una cabecera estática; ingresa la clave solo en la configuración local

OAuth usa clientes públicos, PKCE y registro dinámico de clientes. No se necesita ningún secreto de cliente preemitido. Comienza con acceso de lectura a menos que tu tarea requiera escrituras. Los tokens OAuth se aplican al endpoint MCP; las integraciones REST usan claves de API.

Configuración

Usa las instrucciones del cliente a continuación. Reemplaza los marcadores de clave de API solo en la configuración local y mantén las credenciales fuera de los repositorios compartidos.

Claude Code

claude mcp add --transport http listingsapi https://listingsapi.com/mcp --header "Authorization: API <your-api-key>"

Claude Desktop

Abre Configuración, luego Conectores, luego Agregar conector personalizado, e ingresa https://listingsapi.com/mcp como URL. Claude Desktop te pedirá autenticación cuando el servidor la solicite por primera vez.

Cursor

Agrega a ~/.cursor/mcp.json, o a .cursor/mcp.json dentro de un proyecto:

{
  "mcpServers": {
    "listingsapi": {
      "url": "https://listingsapi.com/mcp"
    }
  }
}

Usa Conectar en la entrada del servidor para completar OAuth en tu navegador. El plugin de Cursor de este repositorio usa la misma configuración. Si necesitas autenticación con clave de API, agrega "headers": { "Authorization": "API <your-api-key>" } dentro de la entrada en la configuración local.

Windsurf

Abre el archivo de configuración MCP desde la configuración MCP de tu editor; la ubicación heredada de Windsurf es ~/.codeium/windsurf/mcp_config.json. Las versiones del editor pueden usar una ruta diferente. Para un cliente que admita OAuth, agrega:

{
  "mcpServers": {
    "listingsapi": {
      "serverUrl": "https://listingsapi.com/mcp"
    }
  }
}

Completa el aviso de autenticación en el navegador. Para autenticación con clave de API, agrega "headers": { "Authorization": "API <your-api-key>" } dentro de la entrada en la configuración local. Consulta la documentación actual de Cascade MCP para tu versión del editor.

Gemini CLI

Instala este repositorio como una extensión:

gemini extensions install https://github.com/listings-api/listingsapi-mcp

Reinicia Gemini CLI, luego ejecuta /mcp auth listingsapi y completa el inicio de sesión en el navegador. Usa /mcp para inspeccionar la conexión y las herramientas descubiertas. La extensión habilita OAuth y no necesita configuración de clave de API.

Para una configuración con clave de API en lugar de la extensión, agrega esta entrada al objeto mcpServers existente en ~/.gemini/settings.json:

{
  "mcpServers": {
    "listingsapi": {
      "httpUrl": "https://listingsapi.com/mcp",
      "headers": { "Authorization": "API ${LISTINGSAPI_API_KEY}" }
    }
  }
}

Proporciona LISTINGSAPI_API_KEY a través de tu entorno local. Usa una configuración de conexión a la vez. Consulta la documentación MCP de Gemini para obtener detalles de autenticación y configuración.

Cline

Abre Servidores MCP, luego Servidores remotos, agrega https://listingsapi.com/mcp y selecciona Streamable HTTP. Completa Autenticar si tu versión de Cline lo ofrece. Para configuración manual, usa "type": "streamableHttp"; omitir type usa SSE heredado por defecto. La guía de instalación de Cline incluye la configuración completa, el respaldo con clave de API y un procedimiento de verificación de solo lectura.

VS Code con GitHub Copilot

Agrega a .vscode/mcp.json:

{
  "servers": {
    "listingsapi": {
      "type": "http",
      "url": "https://listingsapi.com/mcp",
      "headers": { "Authorization": "API <your-api-key>" }
    }
  }
}

Cualquier otro cliente

Usa el transporte streamable HTTP con el endpoint y la cabecera anteriores. El servidor no requiere SSE.

Límites de velocidad

Las solicitudes se cuentan contra tu plan de Listings API, no contra este servidor. El plan Launch permite 10 solicitudes por minuto, Growth permite 50 y los límites de Enterprise se acuerdan por cuenta. Cuando superas el límite, la API responde con un 429 y un valor retry_after_seconds que te indica cuánto esperar. Cada respuesta de error también incluye un correlation_id que puedes citar al soporte para que encuentren la solicitud exacta. El detalle completo está en listingsapi.com/docs/rate-limits.

Una nota práctica: un asistente al que se le pide "revisar cada ubicación" emitirá felizmente una solicitud por ubicación. En el plan Launch eso significa una pausa cada diez llamadas, así que acota la pregunta o pide al asistente que trabaje en lotes.

Cosas que vale la pena saber antes de empezar

Los perfiles conectados son lo primero. Responder a una reseña de Google o Facebook, publicar una publicación y leer analíticas de editores requieren que el perfil de Google o Facebook correspondiente esté conectado a tu cuenta y emparejado con la ubicación. Si una llamada de analíticas vuelve vacía o una respuesta falla, un perfil no emparejado es la causa habitual. Conecta y empareja primero, luego ejecuta el flujo de trabajo.

La creación de fichas es asíncrona. Cuando creas una ficha de Google Business Profile, una respuesta exitosa significa que la solicitud fue aceptada, no que la ficha esté activa. Google verifica y aprovisiona según su propio cronograma. Verifica el estado de la ficha más tarde en lugar de asumir que está activa.

Las escrituras son reales. Una respuesta publicada a través de este servidor aparece públicamente en el sitio de reseñas. Una publicación se hace visible en los perfiles conectados. Trata las operaciones de escritura con el mismo cuidado que tendrías en el panel de control.

Las descripciones de ubicación tienen un mínimo. Una ubicación nueva necesita una descripción de al menos 200 caracteres, que es la razón más común por la que una llamada de creación falla en el primer intento.

Solución de problemas

Síntoma	Causa probable	Qué hacer
401 en cada llamada	La clave es incorrecta, expiró o se pegó con un espacio extra	Regenera la clave en la sección Claves de API de tu panel y actualiza la cabecera
403 en una escritura	La clave solo tiene acceso de Lectura	Emite una clave con acceso de Escritura
429	Se alcanzó el límite de velocidad del plan	Espera `retry_after_seconds`, o pide al asistente que trabaje en lotes más pequeños
Las analíticas vuelven vacías	El perfil no está conectado o no está emparejado con la ubicación	Ejecuta las operaciones de cuentas conectadas para vincularlo y emparejarlo
Respuesta aceptada pero no visible	El sitio de reseñas aún la está procesando	Espera unos minutos y actualiza la reseña

Skills del agente

Instala los flujos de trabajo que necesites desde este repositorio con la CLI de Skills. Las skills proporcionan instrucciones; no configuran credenciales, otorgan acceso ni ejecutan flujos de trabajo de clientes durante la instalación.

npx skills add listings-api/listingsapi-mcp

Habilidad	Qué hace
listingsapi-listing-audit	Inspecciona la integridad del perfil, el estado del publicador, los enlaces activos y los candidatos duplicados; produce un plan de reparación priorizado.
listingsapi-review-management	Clasifica reseñas, redacta respuestas y publica o edita solo las respuestas aprobadas.
listingsapi-multi-location-posting	Prepara y publica campañas aprobadas de Google/Facebook en ubicaciones seleccionadas y luego verifica los resultados.
listingsapi-performance-reporting	Compara rendimiento y reputación con ventanas de fechas explícitas, cobertura y advertencias de frescura.
listingsapi-integration	Integra autenticación REST/SDK, configuración de ubicaciones, conexiones de publicadores y verificaciones de envío en una aplicación nueva o existente.
listingsapi	Navegación general de cuenta, requisitos de conexión y orientación sobre Day Pass.

Para elegir una habilidad directamente:

npx skills add listings-api/listingsapi-mcp --skill listingsapi-integration

La habilidad de integración conserva su nombre existente. Su fuente canónica está en skills/ para el descubrimiento estándar; la ruta original listingsapi-integration/ y el ZIP se mantienen como copias de compatibilidad. Ejecuta python3 scripts/package-integration.py después de editar la habilidad de integración canónica. Los flujos de trabajo de solo lectura necesitan acceso de lectura; las respuestas públicas, la publicación de campañas, las ediciones de perfil y las conexiones de publicadores requieren aprobación de la acción concreta y acceso de escritura. Day Pass solo cubre ubicaciones de sandbox y listados de demostración.

Consulta notas de publicación de habilidades para los pasos de validación y lanzamiento. La disponibilidad en GitHub y la indexación de skills.sh son independientes: las preguntas frecuentes de skills.sh describen el descubrimiento mediante telemetría genuina de instalación CLI.

Documentación y soporte

Referencia completa de la API: listingsapi.com/docs
Página del servidor MCP: listingsapi.com/mcp
SDKs para Python y Node: listingsapi.com/sdks
Habilidad de agente para integrar la API en tu propio código: listingsapi-integration
Actores de Apify para uso programado y sin código: apify.com/listingsapi
Soporte: support@listingsapi.com

Acerca de este repositorio

Este repositorio contiene los manifiestos de conexión que leen los directorios y clientes de MCP, además de habilidades de flujo de trabajo de cuenta e integración para desarrolladores. No contiene código de producto. El servicio Listings API en sí es de código cerrado y se ejecuta en listingsapi.com.

Archivo	Leído por
`server.json`	El Registro oficial de MCP en registry.modelcontextprotocol.io
`gemini-extension.json`	Gemini CLI, cuando instalas este repositorio como extensión
`mcp.json` y `.cursor-plugin/plugin.json`	Cursor, para el plugin del marketplace
`llms-install.md`	Cline, para que pueda configurar el servidor por sí mismo
`logo.svg`	Este README y los directorios anteriores
`logo-400.png`	Cline Marketplace, que requiere un PNG de 400×400
`skills/listingsapi/SKILL.md`	Una habilidad conversacional de flujo de trabajo de cuenta, preparada para ClawHub y clientes de habilidades compatibles
`skills/listingsapi-*/`	Habilidades de flujo de trabajo e integración para desarrolladores instalables de forma independiente
`listingsapi-integration/`	Copia de compatibilidad generada de la habilidad de integración, que conserva sus rutas de archivo originales
`listingsapi-integration.zip`	El directorio `skills/listingsapi-integration/` empaquetado para clientes que aceptan una carga de habilidad

Consulta notas de envío al marketplace para rutas de paquetes, requisitos de envío y estado actual de pruebas. Las pruebas de configuración de Cursor y Cline no se han ejecutado para estos cambios.

Licencia

Los manifiestos en este repositorio se publican bajo la Licencia MIT. Consulta LICENSE. El uso de la Listings API en sí se rige por los términos de Listings API.

La habilidad conversacional en skills/listingsapi/ se publica bajo MIT-0 para compatibilidad con ClawHub. La licencia MIT raíz del repositorio y la habilidad de integración existente no cambian.