DispatchSEO

DispatchSEO

             

Website  ·  Discord  ·  Discussions  ·  Versão hospedada

Self-hosted não tem limitações de recursos. Tudo o que a nuvem
paga faz, este repositório faz hoje, nas suas próprias contas, por $0.

_{▶ Assista à prévia}

⚡ Como funciona

1. Sua IA pesquisa. O app Claude em claude.ai, ou um agente de codificação (Claude Code, Codex, Cursor), conecta-se ao DispatchSEO via MCP, lê o playbook servido e extrai palavras-chave dos seus dados do Search Console, do Google Autocomplete e do que já sabe sobre seu produto. As ideias chegam em uma fila com a justificativa anexada.
2. Você aprova, ou não. Cada ideia é um cartão no painel: a palavra-chave, por que é vencível, o ângulo. Aprove, rejeite ou reordene. Prefere piloto automático total? Ative o modo automático e pule a fila completamente.
3. O pipeline constrói. Toda manhã, um trabalho agendado pega a ideia aprovada mais antiga e a transforma em um pull request real contra o repositório do seu site: um guia ou uma pequena ferramenta gratuita, verificada contra o SERP ao vivo e revisada por um revisor de similaridade para que a página doze não pareça a página três.
4. Ele rastreia o que aconteceu. Verificações diárias de ranking, snapshots horários do Search Console, verificação de indexação e uma visão de jornada que informa em qual estágio de SEO você está. Quando um trabalho agendado falha, você recebe um banner vermelho e um e-mail em vez de silêncio.

O backend é deliberadamente simples: estado, agendamento e um portão de aprovação. O pensamento acontece no seu agente, onde seu conhecimento do produto já vive.

🤖 Qual agente de codificação

O DispatchSEO conversa com seu agente via MCP, então "qual agente" é uma pergunta real com uma resposta real — incluindo as partes que ainda não estão prontas.

Conectar é um colar e você obtém todo o conjunto de ferramentas: pesquisa, a fila, aprovações, backlinks, relatórios e construção de um guia quando você pedir. O construtor noturno é a coisa separada — trabalhos agendados que executam um agente sem ninguém assistindo — e todos os três fazem isso. Cada fluxo de trabalho carrega cada agente e pergunta ao painel qual executar, então trocar de agente tem efeito na próxima execução agendada sem mudança no repositório.

A diferença honesta é quem paga: Claude Code roda em uma assinatura que você já tem, Cursor roda na chave de API do seu plano Cursor, e Codex é cobrado pela OpenAI por execução.

Você também pode pular os agentes de codificação completamente. Adicione o DispatchSEO ao app Claude comum em claude.ai como um conector personalizado e seu Claude faz a pesquisa e a escrita na assinatura que você já tem, depois entrega o artigo de volta para o backend verificar, finalizar e publicar. Ele não construirá ferramentas interativas nem executará o construtor noturno, e o claude.ai precisa conseguir alcançar sua instalação, então esse caminho quer uma URL pública em vez de um laptop. O ChatGPT não pode conectar ainda.

docs/AGENTS.md tem os detalhes, os níveis de suporte e como adicionar um agente.

✅ O que você precisa antes de começar

• Um lugar para publicar. Ou WordPress que você mesmo hospeda, conectado uma vez nas Configurações com uma senha de aplicativo e postado diretamente, ou o código-fonte do seu site em um repositório GitHub, onde o conteúdo chega como pull requests. Wix, Squarespace, Shopify, Webflow e Ghost não têm nenhuma das duas portas e não funcionarão.
• Uma IA para dirigir. Sua IA é o motor, e pode ser o app Claude comum em claude.ai ou um agente de codificação. Claude Code roda na assinatura Claude que você já paga; Codex e Cursor fazem tudo o que o Claude Code faz aqui, incluindo o construtor noturno. Codex é cobrado pela OpenAI por execução, e as construções do Cursor usam o uso incluído do seu plano Cursor. Veja a tabela acima.
• Uma máquina com Docker (~1 GB de RAM). Um laptop funciona para um teste, mas uma máquina que fica ligada é muito melhor para uso diário - um VPS de $5, um Raspberry Pi, um desktop que nunca dorme. Os agendamentos só rodam enquanto a máquina está ligada.
• Acesso ao Google Search Console do seu site.

Essa é a lista completa. Sem chaves de API para comprar e sem conta do nosso lado.

📖 Documentação

Tudo está em dispatchseo.com/docs - cada página, cada configuração, cada ferramenta.

Apontando um agente para isto? Adicione .md a qualquer URL de docs para markdown limpo, ou busque o conjunto completo de documentação em uma única solicitação: llms-full.txt. Há um índice em llms.txt e um SKILL.md que orienta um agente na conexão de um site.

Preso durante a configuração? A página de solução de problemas cobre os erros que as pessoas realmente encontram. Se o seu não estiver lá, pergunte no Discord ou nas Discussões - as perguntas são respondidas e geralmente viram uma correção na documentação.

🗓️ Usando no dia a dia

Quando o assistente termina, o ciclo é pequeno de propósito:

A página inicial do painel sempre nomeia a próxima ação, então você não precisa descobrir o que fazer ao abri-lo.

🧰 O que está incluído

• Servidor MCP com o conjunto completo de ferramentas: a fila, palavras-chave, rankings, páginas, estatísticas do GSC, prospects de backlinks, tópicos em tendência, perfil do site. Qualquer coisa que o painel possa fazer, seu agente pode fazer via MCP; paridade entre os dois é uma regra rígida neste código.
• Radar de tendências: escaneie tópicos em ascensão no seu nicho, expanda um tópico em ângulos concretos de guia e coloque os bons na fila.
• Construtores de guias e ferramentas: guias publicam no máximo um por dia, planos e permanentes (então uma fila de trinta ideias aprovadas não vira trinta posts em uma semana); ideias de ferramentas gratuitas são construídas após aprovação.
• Playbook de backlinks: uma lista de prospects pré-preenchida com o texto do seu produto, rastreada por envio.
• Multi-site: uma implantação gerencia qualquer número de sites. Cada projeto tem seu próprio token MCP, seus próprios dados, suas próprias configurações.
• Um painel protegido por senha para o único humano no ciclo.

💵 Quanto custa para rodar

Nada, a menos que você queira dados pagos. Os níveis se acumulam:

O modo gratuito encontra palavras-chave que você pode vencer. O modo pago também sabe quais valem a pena vencer.

☁️ Versão em nuvem

Há uma versão hospedada para quem prefere não rodar uma máquina: nós hospedamos, incluímos os dados de SERP + volume em uma única conta e substituímos o ritual da conta de serviço do Google por um clique. Está em dispatchseo.com. O self-hosting continua completo em recursos de qualquer forma - a nuvem vende conveniência, não capacidade.

🧑‍💻 Desenvolvendo a partir do código-fonte

git clone https://github.com/NeoZi12/dispatchseo
cd dispatchseo
pnpm install
cp .env.local.example .env.local
pnpm dev

Este é o caminho do contribuidor, não a forma de fazer self-host - essa é a instalação Docker de um comando atrás do botão no topo. Preencha .env.local (Supabase + os três segredos) antes de começar, depois abra o painel em localhost:3000.

pnpm build é a verificação de tipos - rode antes de abrir um PR. Não há configuração separada de lint ou testes.

🏗️ Arquitetura, resumidamente

Next.js App Router, Postgres para estado (um contêiner empacotado quando self-hosted, Supabase na versão em nuvem), mcp-handler para o servidor MCP em /api/mcp. Agendamentos e builds rodam na própria stack (cron + contêineres de build) ou no GitHub Actions. Uma única implantação é multi-tenant: o token bearer do MCP seleciona o projeto, os crons iteram sobre todos os projetos, o painel alterna com um cookie.

Arquitetura cobre isso adequadamente. CLAUDE.md tem todas as convenções; foi escrito para agentes, o que acaba tornando-o uma documentação decente para pessoas.

🤝 Contribuindo

Issues antes de PRs, e você deve entender cada linha que enviar, incluindo as assistidas por IA. Detalhes em CONTRIBUTING.md. Perguntas vão para Discussões ou no Discord; vulnerabilidades passam pelo relatório privado.

📄 Licença

AGPL-3.0. Use, faça self-host, faça fork. Se você rodar uma versão modificada como serviço, compartilhe o código-fonte. É só isso.

_{Construído por NeoZi12 · Se o DispatchSEO é útil para você, uma ⭐ ajuda outras pessoas a encontrá-lo.}