Listings API

A API Listings é uma API local de citações e envio de listagens: uma única chamada REST envia um negócio para mais de 50 sites de listagens, incluindo Google Business Profile, Apple Maps, Bing Places, Facebook, Yelp e os demais diretórios, mapas e mecanismos de resposta importantes, e mantém seu nome, endereço, telefone e horários sincronizados em todos os lugares onde aparece. Gerencie locais de negócios, listagens, avaliações, posts e análises locais. Monitore o status das listagens, responda a avaliações, publique posts e analise o desempenho. O DayPass é gratuito quando disponível: ativação em 24 horas, sem cartão de crédito, 2 locais e 10 diretórios de demonstração. O DayPass suporta apenas locais e listagens, sem gravações reais em editores, avaliações, posts ou análises. Site: https://www.listingsapi.com/ Endpoint MCP: https://listingsapi.com/mcp Guia do DayPass: https://listingsapi.com/docs/day-pass.md Cadastro no DayPass: https://listingsapi.com/signup?plan=day-pass&campaign=daypass Repositório: https://github.com/listings-api/listingsapi-mcp

GitHubExperimente este MCPPatrocinado

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Listings API MCP

Conecte qualquer assistente de IA compatível com MCP à Listings API e gerencie listagens de negócios, avaliações, posts e análises locais em mais de 50 diretórios, mapas e mecanismos de busca.

Website · API docs · MCP page · Get an API key · Apify actors

O que é a Listings API

A busca local funciona com dados de negócios. Uma loja, uma clínica ou uma franquia tem nome, endereço, telefone, horário de funcionamento, categorias e fotos, e esses dados precisam ser idênticos no Google, Apple Maps, Bing, Facebook, Yelp, assistentes de voz e dezenas de diretórios menores antes que os mecanismos de busca confiem o suficiente para ranqueá-los. Manter esses dados consistentes manualmente não escala além de algumas unidades.

A Listings API é uma API REST que faz esse trabalho. Você armazena cada localização uma vez, e a API sincroniza com mais de 50 publicadores, rastreia onde cada listagem está ativa, encontra e suprime duplicatas, coleta as avaliações que essas listagens recebem, permite responder a elas, publica posts e ofertas nos perfis conectados e retorna os dados de desempenho que Google, Facebook e Bing reportam. Agências, marcas com múltiplas localizações e sistemas de franquias a usam para gerenciar a presença local de centenas ou milhares de localizações a partir de um só lugar.

O que é este servidor MCP

O Model Context Protocol permite que um assistente de IA chame ferramentas externas. Este servidor expõe a Listings API como um conjunto de ferramentas MCP, para que um assistente como Claude, Cursor, Windsurf, Gemini CLI ou Cline possa consultar suas localizações, ler suas avaliações, redigir e publicar respostas, agendar posts e extrair análises em conversa natural, usando sua própria conta e seus próprios dados.

É um servidor remoto. Ele roda em https://listingsapi.com/mcp e usa Streamable HTTP. Nenhum pacote local ou build é necessário. Aponte seu cliente para a URL e faça login pelo fluxo OAuth no navegador, ou use uma chave de API existente onde o cliente exigir um cabeçalho.

https://listingsapi.com/mcp

O que você pode fazer com ele

Uma vez conectado, o assistente pode trabalhar em cinco áreas da sua conta.

Localizações. Crie e atualize perfis de localização, busque localizações e leia seus detalhes. Uma localização é o registro mestre usado pelas listagens dos publicadores.

Listagens e citações. Veja quais publicadores atualmente exibem uma localização e em que estado cada listagem está, liste os sites cobertos pelo seu plano, obtenha as listagens duplicatas que a rede detectou para uma localização ou para toda a sua conta, e marque uma listagem como duplicata para que ela seja suprimida, ou limpe esse sinal se a correspondência estiver errada. A cobertura de assistentes de voz é reportada separadamente.

Avaliações. Leia avaliações, busque avaliações específicas por ID, inspecione análises de avaliações e publique respostas onde o publicador conectado suportar. Respostas publicadas aparecem no site de avaliações.

Posts. Leia posts existentes e publique posts em perfis conectados suportados. Verifique o contrato atual das ferramentas para publicadores e payloads suportados.

Análises. Leia o desempenho do Google, Facebook e Bing para qualquer localização: visualizações de busca, visualizações de mapa, solicitações de rota, chamadas, cliques no site e o restante, para qualquer intervalo de datas que você pedir.

Há também um conjunto de operações de contas conectadas para vincular uma conta do Google ou Facebook, corresponder seus perfis às suas localizações e criar uma nova listagem do Google Business Profile para uma localização que não tenha nenhuma.

Operações destrutivas, como arquivar localizações e excluir posts, não são expostas como ferramentas MCP. Use o guia MCP e as ferramentas de documentação do servidor para verificar as operações atualmente disponíveis.

Exemplos de solicitações

Uma vez que o servidor esteja conectado, estes são os tipos de coisas que você pode pedir ao seu assistente.

"Liste todas as localizações que temos no Texas e me diga quais estão sem número de telefone."
"Mostre todas as avaliações abaixo de três estrelas da última semana em todas as lojas, agrupadas por localização."
"Redija uma resposta para a avaliação mais recente do Google da loja de Austin, mantenha abaixo de 60 palavras e publique."
"Publique um post de oferta sobre 20 por cento de desconto em manutenção para todas as localizações da região Nordeste, válido até o fim do mês."
"Compare solicitações de rota e chamadas telefônicas das nossas dez principais lojas neste mês em relação ao mês passado."
"Quais das nossas localizações ainda não têm uma listagem no Google Business Profile?"

O que você precisa

Uma conta na ListingsAPI. Veja planos e cadastro para acesso de produção, ou confira a disponibilidade do Day Pass abaixo. Clientes compatíveis com OAuth permitem que você faça login sem copiar uma chave de API para um arquivo de configuração.

Experimente grátis com um day pass

Verifique a disponibilidade ao vivo antes de se cadastrar; o Day Pass é oferecido por períodos limitados. Enquanto open for verdadeiro, você pode ativar um sandbox gratuito de 24 horas em cadastro do Day Pass. Ele cobre até 2 localizações e sincroniza com 10 diretórios demo da ListingsAPI. Nunca escreve em publicadores reais. Avaliações, posts, redes sociais, análises, contas conectadas e webhooks são excluídos.

O cadastro pede seu nome, e-mail e empresa, além da aceitação dos Termos de Serviço e da Política de Privacidade. As 24 horas começam quando você ativa o passe pelo link enviado por e-mail ou pelo código de 6 dígitos. Leia o guia do Day Pass para limites atuais e etapas de ativação. Em um cliente OAuth, escolha Envie-me um link de login com o e-mail do Day Pass. Para clientes com chave de API, configure a chave do Day Pass localmente usando o mesmo prefixo de cabeçalho API. Instalar um plugin ou skill não inicia um passe.

As chaves carregam um nível de acesso. Uma chave com acesso de Leitura cobre todas as consultas e relatórios. Criar e atualizar localizações, responder a avaliações, publicar posts e conectar contas exigem uma chave com acesso de Escrita.

O servidor aceita duas formas de autenticação:

Método	Cabeçalho	Use quando
OAuth 2.0	Gerenciado pelo seu cliente	Seu cliente suporta o fluxo de login e consentimento no navegador
Chave de API	`Authorization: API <your-key>`	Seu cliente exige um cabeçalho estático; insira a chave apenas nas configurações locais

OAuth usa clientes públicos, PKCE e registro dinâmico de clientes. Nenhum segredo de cliente pré-emitido é necessário. Comece com acesso de leitura, a menos que sua tarefa exija escritas. Os tokens OAuth se aplicam ao endpoint MCP; integrações REST usam chaves de API.

Configuração

Use as instruções do cliente abaixo. Substitua os placeholders de chave de API apenas nas configurações locais e mantenha as credenciais fora de repositórios compartilhados.

Claude Code

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

Claude Desktop

Abra Configurações, depois Conectores, depois Adicionar conector personalizado e insira https://listingsapi.com/mcp como a URL. O Claude Desktop solicitará autenticação quando o servidor pedir pela primeira vez.

Cursor

Adicione a ~/.cursor/mcp.json, ou a .cursor/mcp.json dentro de um projeto:

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

Use Connect na entrada do servidor para concluir o OAuth no seu navegador. O plugin Cursor deste repositório usa a mesma configuração. Se você precisar de autenticação por chave de API, adicione "headers": { "Authorization": "API <your-api-key>" } dentro da entrada nas configurações locais.

Windsurf

Abra o arquivo de configuração MCP nas configurações MCP do seu editor; o local legado do Windsurf é ~/.codeium/windsurf/mcp_config.json. Versões do editor podem usar um caminho diferente. Para um cliente que suporta OAuth, adicione:

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

Conclua o prompt de autenticação no navegador. Para autenticação por chave de API, adicione "headers": { "Authorization": "API <your-api-key>" } dentro da entrada nas configurações locais. Veja a documentação atual do Cascade MCP para a sua versão do editor.

Gemini CLI

Instale este repositório como uma extensão:

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

Reinicie o Gemini CLI e execute /mcp auth listingsapi e conclua o login no navegador. Use /mcp para inspecionar a conexão e as ferramentas descobertas. A extensão habilita OAuth e não precisa de configuração de chave de API.

Para uma configuração com chave de API em vez da extensão, adicione esta entrada ao objeto mcpServers existente em ~/.gemini/settings.json:

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

Forneça LISTINGSAPI_API_KEY por meio do seu ambiente local. Use uma configuração de conexão por vez. Veja a documentação MCP do Gemini para detalhes de autenticação e configuração.

Cline

Abra MCP Servers, depois Remote Servers, adicione https://listingsapi.com/mcp e selecione Streamable HTTP. Conclua Authenticate se a sua versão do Cline oferecer. Para configurações manuais, use "type": "streamableHttp"; omitir type usa o padrão SSE legado. O guia de instalação do Cline inclui a configuração completa, fallback de chave de API e um procedimento de verificação somente leitura.

VS Code com GitHub Copilot

Adicione a .vscode/mcp.json:

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

Qualquer outro cliente

Use o transporte streamable HTTP com o endpoint e o cabeçalho acima. O servidor não exige SSE.

Limites de taxa

As solicitações são contabilizadas no seu plano da Listings API, não neste servidor. O plano Launch permite 10 solicitações por minuto, o Growth permite 50 e os limites do Enterprise são acordados por conta. Quando você excede, a API responde com 429 e um valor retry_after_seconds que informa quanto tempo esperar. Toda resposta de erro também carrega um correlation_id que você pode citar ao suporte para que eles encontrem a solicitação exata. Detalhes completos estão em listingsapi.com/docs/rate-limits.

Uma nota prática: um assistente que recebe a instrução de "verificar todas as localizações" vai emitir uma solicitação por localização. No plano Launch, isso significa uma pausa a cada dez chamadas, então limite o escopo da pergunta ou peça ao assistente para trabalhar em lotes.

Coisas que vale a pena saber antes de começar

Perfis conectados vêm primeiro. Responder a uma avaliação do Google ou Facebook, publicar um post e ler análises de publicadores exigem que o perfil correspondente do Google ou Facebook esteja conectado à sua conta e correspondido à localização. Se uma chamada de análise voltar vazia ou uma resposta falhar, um perfil não correspondido é a causa usual. Conecte e corresponda primeiro, depois execute o fluxo de trabalho.

A criação de listagens é assíncrona. Quando você cria uma listagem no Google Business Profile, uma resposta bem-sucedida significa que a solicitação foi aceita, não que a listagem está ativa. O Google verifica e provisiona no próprio cronograma. Verifique o status da listagem mais tarde em vez de assumir que ela está no ar.

Escritas são reais. Uma resposta publicada por este servidor aparece publicamente no site de avaliações. Um post vai ao ar nos perfis conectados. Trate operações de escrita com o mesmo cuidado que você teria no painel.

Descrições de localização têm um mínimo. Uma nova localização precisa de uma descrição de pelo menos 200 caracteres, que é o motivo mais comum para uma chamada de criação falhar na primeira tentativa.

Solução de problemas

Sintoma	Causa provável	O que fazer
401 em toda chamada	Chave errada, expirada ou colada com um espaço extra	Regere a chave na seção API Keys do seu painel e atualize o cabeçalho
403 em uma escrita	A chave tem apenas acesso de Leitura	Emita uma chave com acesso de Escrita
429	Limite de taxa do plano atingido	Aguarde `retry_after_seconds`, ou peça ao assistente para trabalhar em lotes menores
Análises voltam vazias	Perfil não conectado ou não correspondido à localização	Execute as operações de contas conectadas para vincular e corresponder
Resposta aceita mas não visível	O site de avaliações ainda está processando	Aguarde alguns minutos e atualize a avaliação

Skills do agente

Instale os fluxos de trabalho que você precisa deste repositório com a Skills CLI. Skills fornecem instruções; elas não configuram credenciais, concedem acesso ou executam fluxos de trabalho do cliente durante a instalação.

npx skills add listings-api/listingsapi-mcp

Skill	O que faz
listingsapi-listing-audit	Inspeciona a completude do perfil, status do editor, links ativos e candidatos a duplicatas; produz um plano de reparo priorizado.
listingsapi-review-management	Faz triagem de avaliações, redige respostas e publica ou edita apenas respostas aprovadas.
listingsapi-multi-location-posting	Prepara e publica campanhas aprovadas do Google/Facebook em locais selecionados e, em seguida, verifica os resultados.
listingsapi-performance-reporting	Compara desempenho e reputação com janelas de datas explícitas, cobertura e ressalvas de atualização.
listingsapi-integration	Integra autenticação REST/SDK, configuração de locais, conexões de editores e verificações de envio em um aplicativo novo ou existente.
listingsapi	Navegação geral da conta, pré-requisitos de conexão e orientações sobre o Day Pass.

Para escolher um skill diretamente:

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

O skill de integração mantém seu nome existente. Sua fonte canônica está em skills/ para descoberta padrão; o caminho original listingsapi-integration/ e o ZIP são mantidos como cópias de compatibilidade. Execute python3 scripts/package-integration.py após editar o skill de integração canônico. Fluxos de trabalho somente leitura precisam de acesso de leitura; respostas públicas, publicação de campanhas, edições de perfil e conexões de editores exigem aprovação da ação concreta e acesso de escrita. O Day Pass cobre apenas locais de sandbox e listagens de demonstração.

Consulte notas de publicação de skills para etapas de validação e lançamento. A disponibilidade no GitHub e a indexação do skills.sh são separadas: o FAQ do skills.sh descreve a descoberta por meio de telemetria genuína de instalação via CLI.

Documentação e suporte

Referência completa da API: listingsapi.com/docs
Página do servidor MCP: listingsapi.com/mcp
SDKs para Python e Node: listingsapi.com/sdks
Skill de agente para integrar a API ao seu próprio código: listingsapi-integration
Atores Apify para uso agendado e sem código: apify.com/listingsapi
Suporte: support@listingsapi.com

Sobre este repositório

Este repositório contém os manifestos de conexão que diretórios e clientes MCP leem, além de skills de fluxo de trabalho de conta e integração para desenvolvedores. Ele não contém código de produto. O serviço Listings API em si é de código fechado e roda em listingsapi.com.

Arquivo	Lido por
`server.json`	O Registro MCP oficial em registry.modelcontextprotocol.io
`gemini-extension.json`	Gemini CLI, quando você instala este repositório como uma extensão
`mcp.json` e `.cursor-plugin/plugin.json`	Cursor, para o plugin do marketplace
`llms-install.md`	Cline, para que ele possa configurar o servidor por conta própria
`logo.svg`	Este README e os diretórios acima
`logo-400.png`	Cline Marketplace, que exige um PNG de 400×400
`skills/listingsapi/SKILL.md`	Um skill de fluxo de trabalho conversacional de conta, preparado para ClawHub e clientes de skill compatíveis
`skills/listingsapi-*/`	Skills de fluxo de trabalho e integração para desenvolvedores instaláveis de forma independente
`listingsapi-integration/`	Cópia de compatibilidade gerada do skill de integração, preservando seus caminhos de arquivo originais
`listingsapi-integration.zip`	O diretório `skills/listingsapi-integration/` empacotado para clientes que aceitam upload de skill

Consulte notas de envio ao marketplace para caminhos de pacotes, pré-requisitos de envio e status atual dos testes. Os testes de configuração do Cursor e do Cline não foram executados para estas alterações.

Licença

Os manifestos neste repositório são lançados sob a Licença MIT. Consulte LICENSE. O uso da própria Listings API é regido pelos termos da Listings API.

O skill conversacional em skills/listingsapi/ é lançado sob MIT-0 para compatibilidade com ClawHub. A licença MIT raiz do repositório e o skill de integração existente permanecem inalterados.