LotsDirectory

npx add-mcp 'https://api.lots.directory/mcp'

Pergunte ao seu agente, por exemplo.

Assim que o LotsDirectory estiver conectado, solicitações simples como estas funcionam.

Conecte-se em dois minutos.

Claude

Configurações → Conectores → Adicionar conector personalizado. Cole a URL, conecte-se e faça login com sua conta Lots.

ChatGPT

Configurações → Apps e Conectores → Avançado → ative o Modo de desenvolvedor, depois crie um conector com a URL e faça login.

Claude Code

claude mcp add --transport http lots-directory https://api.lots.directory/mcp

Codex

codex mcp add lots-directory --url https://api.lots.directory/mcp

Cursor, Windsurf e outros

{
  "mcpServers": {
    "lots-directory": {
      "url": "https://api.lots.directory/mcp"
    }
  }
}

Agentes de nuvem sem MCP

Dê ao agente https://api.lots.directory/docs.md e uma chave de API de lotstech.com/api. Ele chama a API REST com Authorization: Bearer <key>.

Todo servidor usa OAuth: seu agente age como você, dentro das suas próprias funções e espaços de trabalho. Você pode desconectá-lo a qualquer momento pelo aplicativo.

36 ferramentas, também endpoints REST.

Cada ferramenta está disponível via MCP e como endpoint REST em https://api.lots.directory/api/v1/lotsdirectory.

Responder a uma pergunta

PATCH /questions/:id

Responda a uma pergunta em um anúncio que você possui.

Verificar o selo LotsDirectory

POST /listings/:id/verify-badge

Verifique se o site do produto exibe o selo LotsDirectory (um link para lots.directory/products/<slug>; o trecho está em get_my_listing badge.snippet). Encontrado: o anúncio se torna Verificado, o link para o site é seguido enquanto o selo estiver ativo, e um anúncio gratuito aguardando seu selo é publicado. O resultado informa o que foi lido e por que o selo não foi encontrado (por exemplo, uma página construída apenas com JavaScript).

Concluir upload de imagem do produto

POST /images/uploads/complete

Verifique os bytes reais enviados e o tamanho/tipo reservado antes de anexar uma imagem. Retorna a URL; no máximo 8 imagens distintas por anúncio, incluindo logotipo e capa.

Confirmar pagamento do Directory Pro

Confirme um pagamento do Directory Pro após o retorno do checkout. Ativa apenas um pedido pago para este produto e proprietário. Repetir não estende a promoção.

Criar upload de imagem do produto

POST /images/uploads

Envie uma imagem local: obtenha uma URL PUT assinada de 15 minutos, envie os bytes e depois complete_listing_image_upload. Tamanho exato, no máximo 2 MB. Apenas JPEG/PNG/WebP/GIF.

Excluir imagem de produto não utilizada

POST /images/delete

Exclua uma imagem enviada que você possui. Remova-a do anúncio e salve primeiro. Libera um slot de upload não anexado.

Obter categoria

GET /public/categories/:slug

Obtenha uma categoria com seus produtos publicados.

Obter oferta do Directory

Leia a oferta atual do Directory, preço, limites de imagem, contagem de diretórios verificados e como o Domain Rating é rastreado (Directory Pro diariamente, anúncios Verificados gratuitos semanalmente). O preço está presente apenas quando o checkout de $20 está realmente ativado.

Obter histórico de Domain Rating

Leia a série de Domain Rating de um produto que você possui: valor atual, quando foi verificado, o melhor valor e os últimos 90 dias. Produtos Directory Pro são verificados todos os dias; produtos Verificados gratuitos (o selo LotsDirectory no seu site) uma vez por semana, às segundas-feiras. Produtos não reivindicados e reivindicados não são rastreados. Domain Rating por Ahrefs.

Obter meu produto

GET /listings/:id

Obtenha detalhes completos de um anúncio que você possui (para edição), incluindo trust_state; badge: o trecho do selo para copiar e colar, as últimas verificações do selo e se o anúncio aguarda seu selo para publicar; launch: sua semana de lançamento (status upcoming, live ou ended), sua posição e votos no quadro semanal, semanas selecionáveis para Directory Pro (set_launch_week) e quaisquer vitórias de Produto da Semana com seu trecho de selo; e traffic: os últimos 30 dias de visualizações de página, cliques para o site do produto e leituras por crawlers de IA (GPTBot, ClaudeBot, PerplexityBot e outros, a partir do user agent).

Obter meu perfil

GET /me/profile

Obtenha o perfil autenticado do criador, com email_preferences: dr_updates (novo recorde histórico de Domain Rating), launch_results (Produto da Semana) e badge_alerts (selo ausente em um produto Verificado). Todos estão ativados por padrão; todo e-mail tem um link de cancelamento de inscrição com um clique.

Obter um diretório

Leia um diretório auditado e o progresso salvo para um produto que você possui: link de envio, relevance_tier, data do anúncio mais recente, tempo de aprovação quando o diretório informa, e agent_submission (método, endpoints, docs, auth, o que um agente pode fazer, o que o proprietário deve concluir e a página de onde foi lido). Antes de abrir um navegador, use agent_submission; se for form ou unknown, verifique /llms.txt, /openapi.json e /.well-known/agents.json do site. Nunca conclua pagamento ou criação de conta sem o proprietário. Requisitos e taxas não são inventados.

Obter produto

GET /public/listings/:slug

Obtenha um único produto publicado por slug. trust_state é unclaimed (listado a partir do site público do produto), claimed (o proprietário provou um e-mail no domínio), verified (o proprietário exibe o selo LotsDirectory) ou pro; link_rel é o rel usado para links ao site do produto.

Obter análises do produto

GET /listings/:id/analytics

Leia visualizações, cliques e uma taxa de visualização para clique de um produto Directory Pro que você possui. Não há atribuição de origem. Produtos gratuitos recebem PRO_REQUIRED.

Obter direitos do produto

Leia o status Free ou Directory Pro, trust_state, cota de imagens, datas de promoção e capacidades de um produto que você possui. checkout_needs_verification é true até o anúncio ser Verificado. Directory Pro também escolhe sua semana de lançamento (set_launch_week) e é destacado na página inicial nessa semana. Não revela o produto de outro proprietário.

Obter preparação do produto

Leia o pacote reutilizável de preparação do produto para um produto Directory Pro que você possui. format text ou markdown retorna conteúdo copiável. submission_routes lista os diretórios de catálogo aos quais um agente pode enviar (MCP, REST, um link de rascunho que o proprietário conclui, ou um pull request no GitHub) e a regra para o restante: navegador apenas como último recurso, nunca pagamento ou criação de conta sem o proprietário. Campos ausentes permanecem ausentes. Nada é inventado.

Listar categorias

GET /public/categories

Liste todas as categorias do diretório.

Listar progresso do diretório

Liste o progresso salvo do diretório para um produto que você possui. format=text retorna um resumo copiável. As contagens incluem diretórios que não foram iniciados.

Listar perguntas recebidas

GET /me/questions

Liste perguntas feitas sobre seus produtos (para responder).

Listar meus produtos

GET /me/listings

Liste anúncios de propriedade do usuário autenticado, com o trust_state de cada anúncio.

Listar notificações

GET /me/notifications

Liste as notificações do usuário autenticado.

Listar produtos

GET /public/listings

Liste produtos de diretório publicados com filtros e ordenação. Cada cartão tem trust_state (unclaimed, claimed, verified ou pro) e link_rel.

Listar lançamentos desta semana

O quadro semanal de lançamentos do LotsDirectory. Uma semana de lançamento vai de segunda-feira 00:00 UTC a domingo 23:59 UTC. Apenas produtos Verificados e Pro lançam; eles são classificados pelos votos recebidos durante sua semana de lançamento (empates: mais votos no total, depois o produto que entrou na semana primeiro). period: this_week (padrão), last_week ou this_month. Cada entrada tem rank, week_votes, launch_week e winner_rank (1 a 3 quando a semana termina). resets_at é o próximo reset semanal. No reset, os 3 primeiros com pelo menos um voto se tornam #1, #2 e #3 Produto da Semana.

Listar diretórios verificados

Liste os diretórios auditados para um produto que você possui, com seu progresso salvo. Cada diretório foi verificado quanto a novos anúncios nos últimos 90 dias e envios abertos, e carrega relevance_tier: core_launch (plataformas de lançamento e diretórios de startups), review_site, community, ai_directory (mostrado apenas para produtos de IA) ou niche. relevant=true mantém os que se encaixam neste produto; tier filtra por um tipo. agent_submission diz como enviar: mcp ou rest (um agente envia pela API), draft-link (um agente prepara um rascunho que o proprietário conclui), github-pr (um pull request da conta GitHub do proprietário), email, ou form (navegador). agent_submittable=true lista apenas as rotas de agente. Isso não registra nada e não envia nada. Outros filtros: search, category, pricing, link type, minimum DR, progress state.

Gerenciar publicação do produto

Publique, remova da lista, mantenha como rascunho privado ou agende um anúncio que você possui. O resultado informa se está público, privado, agendado, aguardando revisão ou aguardando_badge (um anúncio gratuito publica quando verify_badge encontra o selo LotsDirectory em seu site).

Marcar notificação como lida

POST /me/notifications/read

Marque uma ou todas as notificações como lidas.

Escolher a semana de lançamento

Directory Pro: escolha a semana em que um produto que você possui lança no quadro semanal do LotsDirectory, a semana atual ou uma das próximas 12 (week_start é qualquer data nessa semana, AAAA-MM-DD; a semana vai de segunda-feira 00:00 UTC a domingo 23:59 UTC). O produto é destacado na página inicial durante sua semana de lançamento. Uma semana de lançamento é bloqueada quando começa, então um produto lança uma única vez. Envie week_start vazio para limpar uma semana que não começou. Anúncios Verificados gratuitos entram na próxima semana aberta automaticamente (veja get_my_listing launch) e recebem PRO_REQUIRED aqui; anúncios Unclaimed e Claimed recebem NOT_ELIGIBLE.

Publicar uma atualização do produto

POST /listings/:id/updates

Publique uma atualização em um produto Directory Pro que você possui. Produtos gratuitos não podem postar atualizações. Perguntas permanecem gratuitas.

Registrar progresso do diretório

Registre ou atualize o progresso de um diretório em um produto que você possui. Isso não envia o formulário. submitted precisa de um recibo ou nota. live precisa da URL pública do anúncio. needs_action precisa da próxima ação do proprietário. Uma nova tentativa idêntica não altera a revisão.

Pesquisar produtos

GET /public/search

Pesquisa de digitação antecipada em produtos publicados.

Iniciar checkout do Directory Pro

Inicie um checkout único de $20 para um produto que você possui. O anúncio deve ser Verificado primeiro (o selo LotsDirectory em seu site, verificado com verify_badge); caso contrário, recusa com VERIFY_FIRST. Recusa a menos que a oferta do servidor esteja ativada e o produto de cobrança seja $20 USD. Não envia o produto para outros diretórios.

Enviar um produto

POST /listings

Crie um anúncio de produto que você possui. Um anúncio gratuito publica quando o selo LotsDirectory está no site do produto: até verify_badge encontrá-lo, o anúncio permanece como rascunho (publication.status awaiting_badge, com o trecho). Uma vez Verificado e publicado, ele entra automaticamente na próxima semana de lançamento aberta. publication: publish (padrão), draft para mantê-lo privado enquanto prepara, ou schedule com scheduled_publish_at. Gratuito inclui 2 imagens distintas, Directory Pro 8; logotipo, capa, galeria e miniaturas contam uma vez por URL; cada imagem no máximo 2 MB.

Atualizar um produto

PATCH /listings/:id

Atualize um produto que você possui. Um produto gratuito pode manter um conjunto de imagens herdado apenas quando as URLs não mudam. Qualquer mudança real de imagem deve caber em 2 imagens, ou 8 após Directory Pro. Não envie is_pro ou um limite de imagens; o servidor decide.

Atualizar perfil do criador

PATCH /me/profile

Atualize o perfil autenticado do criador. email_preferences liga ou desliga e-mails do proprietário: dr_updates, launch_results, badge_alerts (true ou false; tópicos omitidos mantêm sua configuração).

Atualizar preparação do produto

Salve substituições de preparação, variantes ou notas para um produto Directory Pro que você possui. Envie null ou em branco para limpar uma substituição. Passe expected_revision para evitar sobrescrever um salvamento mais recente. Variantes acima do limite de caracteres são mantidas e avisadas, não truncadas.

Enviar imagem do produto

POST /images

Envie uma URL de imagem ou imagem base64 para o armazenamento do Directory. Máximo 2 MB, JPEG/PNG/WebP/GIF. Produtos gratuitos podem usar 2 imagens distintas e produtos Directory Pro podem usar 8, incluindo logotipo e capa. A mesma URL conta uma vez. Passe listing_id para que o servidor aplique o limite do produto. No máximo 2 envios podem permanecer não anexados.

Perguntas, respondidas.

Qual é a URL do servidor MCP do LotsDirectory?

https://api.lots.directory/mcp. Adicione-o como um servidor MCP remoto (conector personalizado) no seu agente de IA e faça login com sua conta Lots.

Quais agentes funcionam com o LotsDirectory?

Claude, ChatGPT (modo de desenvolvedor), Claude Code, Codex, Cursor, Windsurf e qualquer outro cliente que suporte MCP remoto com OAuth. Agentes sem MCP usam a API REST com uma chave de API.

Onde estão os documentos da API do LotsDirectory? https://api.lots.directory/docs.md: Markdown escrito para que um agente de IA possa lê-lo. As solicitações vão para https://api.lots.directory/api/v1/lotsdirectory com Authorization: Bearer <your key>.

Como obtenho uma chave de API do LotsDirectory?

Use Gerar chave nesta página ou em lotstech.com/api. Entre com sua conta LotsTech, nomeie a chave e copie-a uma vez. Você pode revogá-la lá a qualquer momento.

O acesso a MCP ou API custa algo extra?

Não. Está incluído no LotsDirectory. Você paga apenas pelo plano ou uso do próprio LotsDirectory, e seu provedor de IA cobra o próprio uso.