All APIs Gateway

Gateway de API de web-inteligência: 17 APIs como 20 ferramentas MCP para SEO e scraping. Pagamento por chamada via USDC.

Documentação

API Gateway — 17 APIs para Agentes de IA

Servidor MCP único expondo 17 APIs de produção atrás de um domínio público único.

Todas as APIs são servidas em https://momentumbysamay.online/api/<apiname> (DNS → 167.71.22.95), um gateway nginx único com HTTPS Let's Encrypt. O pacote Website Intelligence roda no droplet 1; Marketing, Web Scraper, PDF e Email Verify são proxy reverso a partir do droplet 2.


🚀 O Que É Isso

Um servidor MCP (Model Context Protocol) que encapsula 17 APIs reais e implantadas como ferramentas MCP. Qualquer agente de IA com suporte a MCP pode descobrir, chamar e pagar por essas APIs programaticamente.

Como os Agentes de IA Usam

  1. Conectar — Agentes conectam via MCP (stdio ou HTTP)
  2. Descobrir — O agente chama list_tools() → vê 20 ferramentas
  3. Pagar — O agente chama generate_invoice + check_balance para pagamento em cripto
  4. Usar — O agente chama qualquer ferramenta de API, os créditos são deduzidos automaticamente

Modelo de Receita

CanalComo Gera DinheiroStatus
🤖 Agentes de IA via MCPAgentes descobrem ferramentas → geram fatura → enviam USDC → usam as APIs✅ NO AR
🤖 Agentes de IA via .well-known/ai-plugin.jsonAgentes GPT da OpenAI descobrem APIs automaticamente✅ NO AR
Marketplace RapidAPIAssinaturas de US$ 29–US$ 199/mês📦 Pronto — precisa de conta de provedor RapidAPI
Apify StorePreço por execução📦 Pronto, não publicado
api.marketMarketplace global de APIs📦 Pronto (problemas com Redis)

📋 Inventário de APIs — 17 APIs + 3 Ferramentas de Pagamento

🖥️ Website Intelligence (/api/website-intel) — 10 APIs

#Ferramenta MCPAPIDescriçãoPreço
1website_to_markdownWebsite → MarkdownConverte qualquer página web em Markdown limpoUS$ 0,0005
2website_metadataMetadados do WebsiteMeta tags, OG, Twitter Cards, títulos, imagens, faviconUS$ 0,0002
3technology_detectorDetector de TecnologiaCMS, frameworks, analytics, CDN, tecnologia do servidorUS$ 0,0003
4contact_extractorExtrator de ContatosE-mails, telefones, links sociais, endereçosUS$ 0,0005
5ai_website_summaryResumo de Website com IAResumo estruturado + narrativa opcional com IAUS$ 0,002
6opengraph_extractorExtrator OpenGraphTags OG, Twitter Cards, dados de pré-visualização socialUS$ 0,0002
7robots_txt_parserAnalisador de Robots.txtRegras de rastreamento, caminhos bloqueados, URLs de sitemapUS$ 0,0002
8sitemap_parserAnalisador de SitemapDescobre e analisa sitemaps XMLUS$ 0,0005
9ssl_checkerVerificador SSLDetalhes do certificado, validade, nota de segurançaUS$ 0,0002
10dns_lookupConsulta DNSA, AAAA, MX, NS, CNAME, TXT, descoberta de subdomíniosUS$ 0,0002

Pagamento: USDC Solana ($USDC na mainnet Solana)

📊 Pacote de APIs de Marketing (/api/marketing) — 7 APIs

#Ferramenta MCPAPIDescriçãoPreço
11marketing_contact_extractorExtrator de Contatos de MarketingE-mails, telefones, perfis sociais, endereçoUS$ 0,0005
12google_maps_reviewsAvaliações do Google MapsNotas, avaliações, metadados de negócios por Place ID ou pesquisaUS$ 0,001
13business_metadataMetadados de NegóciosCategoria, ano de fundação, horários, certificações, pagamentosUS$ 0,0003
14seo_auditAuditoria de SEOAnálise de SEO on-page com pontuação (0–100)US$ 0,0005
15ai_company_summaryResumo de Empresa com IAVisão geral de negócio com IA + narrativaUS$ 0,002
16marketing_technology_detectorDetector de TecnologiaCMS, frameworks, analytics, hospedagemUS$ 0,0003
17citation_checkerVerificador de CitaçõesPresença em diretórios em 10+ plataformas + pontuação NAPUS$ 0,001

Pagamento: USDC Solana ($USDC na mainnet Solana)

💰 Ferramentas de Pagamento/Gerenciamento — Gratuitas

#Ferramenta MCPDescrição
18get_pricingObtém preços atuais de todas as APIs
19generate_invoiceGera fatura de pagamento USDC Solana
20check_balanceVerifica saldo de créditos de uma chave de API

🔧 Início Rápido

Para Agentes de IA (nativos em MCP)

Configure o servidor MCP no seu agente:

{
  "mcpServers": {
    "all-apis-gateway": {
      "command": "python3",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "WEBSITE_INTEL_BASE": "https://momentumbysamay.online/api/website-intel",
        "WEBSITE_INTEL_KEY": "YOUR_WEBSITE_INTEL_KEY",
        "MARKETING_BUNDLE_BASE": "https://momentumbysamay.online/api/marketing",
        "MARKETING_BUNDLE_KEY": "YOUR_MARKETING_KEY"
      }
    }
  }
}

Para Desenvolvedores (APIs REST diretamente)

Website Intelligence:

# Get an admin key (one-time)
curl -X POST https://momentumbysamay.online/api/website-intel/api/v1/auth/generate-key \
  -H "Content-Type: application/json" \
  -d '{"name":"my-app","tier":"admin"}'

# Call an API
curl -X POST https://momentumbysamay.online/api/website-intel/api/v1/dns-lookup \
  -H "X-API-Key: *** \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

# Get pricing
curl https://momentumbysamay.online/api/website-intel/api/v1/payments/pricing

# Generate payment invoice
curl -X POST https://momentumbysamay.online/api/website-intel/api/v1/payments/invoice \
  -H "Content-Type: application/json" \
  -d '{"api_key": "YOUR_KEY", "amount_usdc": 5.0}'

Pacote de Marketing:

curl -X POST https://momentumbysamay.online/api/marketing/api/v1/contact-extractor \
  -H "X-API-Key: *** \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

💳 Fluxo de Pagamento em Cripto

Ambos os pacotes de APIs aceitam USDC Solana para agentes de IA.

┌─────────────────────────────────────────────┐
│  Payment Flow                                 │
│                                               │
│  1. Agent: POST /payments/invoice             │
│     → Gets: {wallet_address, memo}            │
│                                               │
│  2. Agent: Send USDC to wallet + memo         │
│     (On Solana mainnet)                       │
│                                               │
│  3. Agent: POST /payments/verify              │
│     → Credits added to API key                │
│                                               │
│  4. Agent: Call any API with X-API-Key        │
│     → Credits auto-deduct per call            │
└─────────────────────────────────────────────┘

Carteira do Tesouro: Configurada no droplet (defina a variável de ambiente TREASURY_WALLET)

Token: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (USDC Solana)


📊 Limites de Taxa

PlanoSolicitações/segLimite DiárioPreço
Gratuito2100US$ 0
Iniciante105.000US$ 29/mês
Crescimento3025.000US$ 79/mês
Empresarial100100.000US$ 199/mês

🏗 Arquitetura

MCP Client (Claude Code, Cline, Hermes, any MCP agent)
    │
    ▼
┌──────────────────────────────┐
│  MCP Server (api-gateway)    │
│  - 20 tools                  │
│  - Auth injection            │
│  - Error handling            │
│  - Pricing/cost display      │
└──────┬───────────────────────┘
       │
       ├──→ momentumbysamay.online/api/website-intel: Website Intelligence (10 APIs + payments)
       │       POST .../api/website-intel/api/v1/{endpoint}
       │       POST .../api/website-intel/api/v1/payments/{invoice,verify,balance,pricing}
       │       GET  .../api/website-intel/.well-known/ai-plugin.json
       │
       └──→ momentumbysamay.online/api/marketing: Marketing API Bundle (7 APIs + payments)
               POST .../api/marketing/api/v1/{endpoint}
               POST .../api/marketing/api/v1/payments/{invoice,verify,balance,pricing}
               GET  .../api/marketing/.well-known/ai-plugin.json

📦 Guias de Publicação em Marketplaces

Documentos prontos para registro em cada plataforma:

MarketplaceGuiaStatus
OpenAI GPT Storedocs/gpt-store-guide.md📝 Passo a passo
RapidAPIdocs/rapidapi-publish-guide.md📝 Especificação pronta para upload + textos
Apify StoreVeja os links do console Apify abaixo🔴 Requer aceite dos termos da Store
api.marketEspecificações OpenAPI pré-preparadas em /home/node/api-market-specs/🔴 Indisponibilidade do Redis

🪙 Pagamentos USDC Solana

Documentação: docs/setup-wallet.md

Ambos os pacotes aceitam USDC Solana (token EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v):

  • POST .../api/website-intel/api/v1/payments/invoice — gera carteira + memo
  • POST .../api/website-intel/api/v1/payments/verify — verifica pagamento → adiciona créditos
  • POST .../api/website-intel/api/v1/payments/balance — consulta saldo
  • GET .../api/website-intel/api/v1/payments/pricing — preços por endpoint

Carteira de tesouro Solana real em AMBOS os pacotes: F8tmJqiyEpcSbAbWef3XhsknsnW4gxb2gv6K8ZxEfgE

🌐 Endpoints de Descoberta para Agentes de IA

Cada pacote expõe arquivos de descoberta para agentes de IA em seu caminho de domínio:

EndpointDescrição
.../api/<apiname>/.well-known/ai-plugin.jsonManifesto de ações GPT da OpenAI
.../api/<apiname>/.well-known/openapi.jsonEspecificação OpenAPI para consumo por IA
.../api/<apiname>/api/v1/payments/pricingPreços USDC por endpoint
.../api/<apiname>/healthVerificação de saúde (sem autenticação)
.../api/<apiname>/statusStatus de componentes (sem autenticação)

📈 Monitoramento

EndpointDescriçãoAutenticação
GET /healthVerificação de saúde do serviçoNenhuma
GET /statusStatus de componentes (cache, autenticação, pagamentos)Nenhuma
GET /metricsMétricas operacionais (P50/P95/P99, taxa de acerto do cache)Chave de administrador
GET /dashboardDashboard de uso em HTMLChave de administrador

🔐 Autenticação

  • Cabeçalho: X-API-Key: <your-key> (recomendado)
  • Bearer: Authorization: Bearer <your-key>
  • Parâmetro de consulta: ?api_key=<your-key>

Níveis: free, starter, growth, enterprise, admin


📜 Licença

Privada — Samay Vashisht. Todas as APIs e códigos são proprietários.