Clearlist

O ClearList é um gerenciador de revenda com IA. Mudando de casa, reduzindo o espaço ou apenas limpando a garagem: envie suas fotos e pronto. A IA escreve cada anúncio, pesquisa o preço e encontra as dimensões. Compartilhe um único link onde os compradores já estão. Eles reservam, agendam a retirada e aparecem. Chega de "ainda está disponível?

GitHub

Documentação

ClearList — Superfície para Desenvolvedores e Agentes

ClearList é um gerenciador de revenda com IA: fotografe seus itens, a IA escreve anúncios completos com preço em cerca de 30 segundos, e um link compartilhável gerencia uma fila automática de compradores. Feito para quem está se mudando, reduzindo o tamanho da casa, vendas de espólio e qualquer pessoa se desfazendo de mais do que alguns itens.

Este repositório é a superfície pública para desenvolvedores do ClearList — o servidor Model Context Protocol (MCP) e a documentação que agentes de IA precisam para usar o ClearList programaticamente. Toda ação que um vendedor pode realizar na interface web está disponível aqui através da API e do servidor MCP.

O que está aqui

mcp-server/ — o servidor MCP do ClearList. Qualquer agente compatível com MCP (Claude, ChatGPT, Gemini, Manus, agentes personalizados) pode cadastrar um vendedor, criar anúncios, publicar uma página de venda e gerenciar compradores. Veja o README para configuração completa.
skills/clearlist/ — uma Agent Skill que ensina um agente a conduzir uma venda de ponta a ponta com o servidor MCP acima, incluindo a única coisa que ele nunca deve fazer. Instale com npx skills add Cuneiform-LLC/clearlist-mcp.

Início rápido

O caminho mais rápido é a Agent Skill. Um comando, sem clone, sem build, e funciona em Claude Code, Codex, Gemini CLI, Copilot, Antigravity e dezenas de outros hosts:

npx skills add Cuneiform-LLC/clearlist-mcp

Isso instala a skill clearlist, que ensina ao seu agente todo o fluxo: criação de conta sem navegador, captação de fotos em lote, publicação, a fila de compradores e a única capacidade que ele nunca deve acionar. Também instrui o agente a configurar o servidor MCP abaixo, então este é o único passo que a maioria das pessoas precisa.

Se preferir executar o servidor a partir do código-fonte:

git clone https://github.com/Cuneiform-LLC/clearlist-mcp
cd clearlist-mcp/mcp-server
npm install
npm run build

Depois aponte seu agente para mcp-server/dist/index.js com CLEARLIST_API_URL=https://clearlist.me. O "Fluxo da Vovó" sem conta (o agente cria a conta por meio de conversa) e a configuração para usuários recorrentes estão documentados no README do mcp-server.

Documentos de descoberta ao vivo

Agentes podem descobrir o ClearList diretamente no site, sem necessidade de clone:

Página do desenvolvedor: https://clearlist.me/developers
Documentação da API: https://clearlist.me/docs/api
Especificação OpenAPI 3.1: https://clearlist.me/.well-known/openapi.json
Cartão do servidor MCP (SEP-1649): https://clearlist.me/.well-known/mcp/server-card.json
Cartão do agente (A2A): https://clearlist.me/.well-known/agent-card.json
Índice de agent skills: https://clearlist.me/.well-known/agent-skills/index.json
Catálogo de API (RFC 9727): https://clearlist.me/.well-known/api-catalog
Guia de autenticação: https://clearlist.me/auth.md
llms.txt: https://clearlist.me/llms.txt

Autenticação

Agentes autenticam com uma chave de API (X-ClearList-API-Key: cl_<64-hex>) obtida por meio de um fluxo de código único por e-mail — sem redirecionamento OAuth, sem senha. Detalhes: https://clearlist.me/auth.md

Sobre

Desenvolvido pela Cuneiform LLC. Produto: https://clearlist.me

Licença

MIT — veja LICENSE.