XiaoFlow MCP Server

Servidor MCP oficial para as Ferramentas de SEO da XiaoFlow AI e Inteligência de Mercado do Etsy

Documentação

XiaoFlow MCP Server (`xiaoflow-mcp-server`)

Servidor oficial do Model Context Protocol (MCP) para ferramentas de SEO e inteligência de palavras-chave do XiaoFlow AI.

Conecte Modelos de Linguagem de Grande Escala (LLMs) como Claude Desktop, Cursor, Windsurf e VS Code diretamente às ferramentas de otimização para mecanismos de busca, descoberta de palavras-chave e análise de domínios do XiaoFlow.

Endpoint remoto: https://mcp.xiaoflow.com/mcp

Transporte: MCP Streamable HTTP com OAuth 2.1 / PKCE, além de stdio através do pacote npm

Segurança: Ferramentas de pesquisa somente leitura, exceto criação assíncrona de tarefas de expansão; nenhuma ferramenta destrutiva

Listagens oficiais

✨ Recursos e Capacidades

🔍 Descoberta de Palavras-Chave: Gere palavras-chave de busca de alta intenção e ideias de SEO a partir de sementes de palavra-chave, URL ou domínio.
📊 Análise de Domínio: Analise o desempenho de busca em nível de domínio, métricas de tráfego orgânico e distribuições de palavras-chave.
📈 Análise de Tendências de Busca: Compare demanda de palavras-chave, concorrência, CPC e tendências históricas.
🔒 Autenticação Flexível: Suporta autenticação por chave de API via parâmetros de consulta (?key=), tokens Bearer, variáveis de ambiente ou login OAuth Web.

⚡ Início Rápido

1. Execute via `npx` (stdio)

Execute o servidor diretamente usando npx:

npx -y xiaoflow-mcp-server

Passe sua chave de API XiaoFlow via variável de ambiente:

XIAOFLOW_API_KEY="YOUR_API_KEY" npx -y xiaoflow-mcp-server

2. Conecte via Streamable HTTP com login web (recomendado)

Use o endpoint remoto canônico em clientes que suportam MCP remoto. O cliente descobre o OAuth do XiaoFlow automaticamente e abre o navegador para login e consentimento:

https://mcp.xiaoflow.com/mcp

Clientes legados ainda podem usar https://mcp.xiaoflow.com/sse?key=YOUR_API_KEY.

💻 Guias de Integração de Clientes

Configuração no Cursor

Adicione XiaoFlow MCP ao Cursor:

Nome: xiaoflow
Tipo: http
URL: https://mcp.xiaoflow.com/mcp

Ou clique em Adicionar ao Cursor diretamente no Portal MCP XiaoFlow.

Configuração no Claude Desktop

Adicione a seguinte entrada ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "xiaoflow": {
      "command": "npx",
      "args": ["-y", "xiaoflow-mcp-server"],
      "env": {
        "XIAOFLOW_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf, VS Code e outros clientes remotos

Use configuração HTTP nativa quando disponível:

{
  "mcpServers": {
    "xiaoflow": {
      "type": "http",
      "url": "https://mcp.xiaoflow.com/mcp"
    }
  }
}

Para clientes somente stdio, faça a ponte para o endpoint remoto com OAuth:

{
  "mcpServers": {
    "xiaoflow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.xiaoflow.com/mcp"]
    }
  }
}

🛠️ Ferramentas MCP Disponíveis

Ferramenta MCP	Descrição	Principais Parâmetros de Entrada
`get_keyword_metrics`	Métricas exatas e histórico mensal para uma palavra-chave	`keyword`, `history_months` (1–48), `location`, `language`
`get_related_keywords`	Palavras-chave relacionadas com métricas/histórico e paginação ilimitada	`seed`, `history_months`, `page`, `page_size` (máx. 1.000)
`bulk_keyword_metrics`	Métricas/histórico exatos para até 1.000 palavras-chave	`keywords`, `history_months`, `location`, `language`
`start_keyword_expansion`	Iniciar expansão baseada em rodadas a partir de uma ou mais sementes	`seeds`, `max_iterations`, regras de inclusão/exclusão
`get_keyword_expansion_status`	Consultar uma tarefa de expansão e recuperar resultados	`task_id`, `include_results`
`analyze_url`	Analisar visibilidade de busca de página ou domínio	`url`, `site`, `brand`, `location`, `language`
`get_domain_stats`	Visão geral das métricas de busca e tendências de tráfego para um domínio	`domain`, `brand` (obrigatório: `0`=domain, `1`=brand)
`list_domain_keywords`	Recuperar lista paginada de palavras-chave de domínio	`domain`, `brand`, `page`, `page_size`
`get_keyword_details`	Recuperar métricas de palavras-chave para um período de 12, 24 ou 48 meses	`slug`, `time_range`, `location`, `language`
`discover_keywords`	Descoberta de palavras-chave relacionadas com compatibilidade retroativa	`keyword`, `url`, `site`, `location`, `language`
`bulk_keyword_lookup`	Consulta de métricas em lote com compatibilidade retroativa	`keywords`, `location`, `language`

Aliases legados permanecem disponíveis para compatibilidade retroativa.

Cada ferramenta publica:

descrições para cada parâmetro de entrada;
um esquema de saída JSON nomeado, incluindo campos de sucesso e erro;
anotações de segurança MCP (readOnlyHint, destructiveHint, idempotentHint e openWorldHint);
um título de ferramenta legível para clientes e diretórios MCP.

Exemplos de prompts

Get US English metrics and 24 months of history for "AI SEO tools".

Find every related keyword for "standing desk", 200 per page, and continue
until has_more is false. Return search volume, CPC, competition, intent, and history.

Compare these 1,000 keywords over 48 months and rank them by search volume growth.

Expand "home office" for four rounds, keep terms with at least 100 monthly
searches, and poll the task until it is complete.

🔑 Autenticação

Obtenha sua chave de API no Painel MCP XiaoFlow.

Métodos de autenticação suportados:

Login Web OAuth (recomendado): conecte-se a https://mcp.xiaoflow.com/mcp; clientes compatíveis descobrem OAuth, PKCE e registro dinâmico de clientes automaticamente.
Variável de Ambiente: defina XIAOFLOW_API_KEY ao executar via npx.
Cabeçalho de Autorização: envie Authorization: Bearer YOUR_API_KEY.
Parâmetro de Consulta Legado: acrescente ?key=YOUR_API_KEY à URL SSE legada.

🐳 Docker / Glama

O repositório inclui um Dockerfile multi-estágio de produção para verificação de build em diretórios e implantação stdio:

docker build -t xiaoflow-mcp .
docker run --rm -i \
  -e XIAOFLOW_API_KEY="YOUR_API_KEY" \
  xiaoflow-mcp

A imagem executa como usuário Node sem privilégios, exclui segredos locais e estado de build, e grava mensagens de protocolo MCP apenas na saída padrão (stdout).

🔐 Segurança e tratamento de dados

O login OAuth ocorre apenas em www.xiaoflow.com; clientes MCP nunca recebem sua senha.
Chaves de API e tokens OAuth são enviados apenas ao endpoint de API XiaoFlow configurado.
O servidor não verifica nem envia arquivos de projeto.
Chamadas de ferramentas consultam dados externos do XiaoFlow/Google Ads e podem consumir créditos da conta.
Nenhuma ferramenta exclui ou modifica dados de palavras-chave ou domínios.

Relate vulnerabilidades de forma privada através do proprietário do repositório ou da página de contato do XiaoFlow. Não inclua tokens ou dados de clientes em issues públicas.

✅ Qualidade e compatibilidade

Protocolo MCP: Streamable HTTP e stdio
Autenticação: OAuth 2.1 com PKCE, chave de API Bearer
Esquemas de ferramentas: descrições de parâmetros, esquemas de saída estruturados, anotações
Métodos de descoberta opcionais: recursos e prompts retornam listas vazias válidas
Runtime: Node.js 18+ (node:20-alpine no Docker)
Endpoint contínuo: https://mcp.xiaoflow.com/mcp

XiaoFlow MCP Server

Documentação