ServiceGraph
Acesse o ServiceGraph — um catálogo estruturado com mais de 100 mil empresas de serviços profissionais dos EUA (direito, marketing, consultoria, contabilidade, serviços de TI, arquitetura, engenharia, RH, RP, design) com filtros por setor, serviços oferecidos, localização, porte, avaliações e presença em listagens de terceiros.
Documentação
Habilidades do Agente ServiceGraph
Conjuntos de dados para fundadores — onde lançar, para quem enviar e-mail, quem contratar.
Habilidades de agente para ServiceGraph — conjuntos de dados de negócios estruturados e enriquecidos com métricas que seu agente pode filtrar, classificar e extrair dados de contato. Um único DSL de filtro, um único saldo de créditos, muitos conjuntos de dados:
| Conjunto de dados | Tamanho | Enriquecido com |
|---|---|---|
| Agências (empresas de serviços profissionais dos EUA) | 110 mil+ | serviços · porte · localização · avaliações |
| Diretórios de empresas | 3.500+ | setor · classificação de domínio · tráfego |
| Diretórios de produtos | 850+ | política de envio · classificação de domínio · tráfego |
| Newsletters | 50 mil+ | assinantes · tópicos · cadência de publicações |
| subreddits, influenciadores | em breve |
A habilidade de marca servicegraph funciona com todos os conjuntos de dados — diga "servicegraph" e seu agente descobre quais conjuntos de dados existem, aprende o esquema e os filtros de cada um, pesquisa gratuitamente e desbloqueia detalhes com créditos.
As habilidades específicas find-* cobrem dois conjuntos de dados hoje. Para o conjunto de dados Agências — direito, marketing, design, consultoria, contabilidade, serviços de TI, IA/ML, desenvolvimento web, engenharia, RH, RP, segurança cibernética e muito mais — filtrável por setor, serviços, localização, porte, avaliações e listagens de terceiros. E para o conjunto de dados Diretórios de produtos — onde lançar um produto de software e ganhar backlinks — cobrindo lançamentos gerais de produtos/SaaS, registros de servidores MCP e diretórios de ferramentas de IA / agentes de IA / habilidades de agente, classificados por Classificação de Domínio e tráfego orgânico. Mais habilidades específicas por caso de uso para o newsletter e outros conjuntos de dados chegarão aqui conforme forem lançadas — mesma instalação, mesma chave de API, mesmo DSL.
Compatível com 19+ agentes de IA, incluindo Claude Code, Codex, Cursor, GitHub Copilot, Gemini, Cline, Goose, Windsurf e qualquer outro harness que suporte o formato Agent Skills.
Instalação
Instalar uma habilidade específica
npx skills add nostrband/servicegraph --skill find-service-providers
Instalar todas as habilidades
npx skills add nostrband/servicegraph
Chave de API: navegação, filtragem e cartões resumidos são gratuitos, mas toda chamada precisa de uma chave. Crie uma em
servicegraph.co/profile/api-keys
(2.000 créditos gratuitos no cadastro, sem cartão) e coloque-a no seu shell ou
.env.local como SERVICEGRAPH_API_KEY=vk_…. As habilidades solicitam a chave no primeiro uso e nunca leem o valor para o contexto do modelo.
Habilidades Disponíveis
Qualquer conjunto de dados
servicegraph — o ponto de entrada da marca
A forma genérica e independente de conjunto de dados para usar o ServiceGraph. Inicie nomeando a marca; ele descobre quais conjuntos de dados existem e o esquema e os filtros de cada um por meio da API, pesquisa linhas resumidas gratuitas e desbloqueia detalhes de contato e métricas com créditos — sem conjuntos de dados ou campos codificados, então permanece correto à medida que novos dados chegam.
Use quando:
- "Use o ServiceGraph para encontrar…"
- "Quais conjuntos de dados o ServiceGraph tem?"
- "Pesquise no ServiceGraph por… / procure isso no ServiceGraph"
- "Extraia contatos do ServiceGraph para estes domínios"
- O conjunto de dados necessário ainda não tem uma habilidade específica abaixo
Conjunto de dados de Agências
find-service-providers — a habilidade guarda-chuva
Encontre, pré-selecione, avalie ou enriqueça empresas de serviços profissionais dos EUA em todos os 22 setores do catálogo — direito, marketing, consultoria, contabilidade, serviços de TI, arquitetura, engenharia, RH, RP, design e muito mais.
Use quando:
- "Encontre três escritórios de advocacia boutique de propriedade intelectual na Califórnia"
- "Monte uma longlist de 50 consultorias de gestão de médio porte nos EUA"
- "Aqui estão 12 domínios de agências — extraia informações de contato e confirme quais são baseadas nos EUA"
- A intenção do usuário não se encaixa em uma habilidade mais específica abaixo
find-marketing-agency
Encontre agências de marketing dos EUA — branding, marketing de conteúdo, PPC/mídia paga, redes sociais, e-mail, performance/demand-gen, produção de vídeo, digital full-service. Fixa automaticamente industry:marketing_agency para que o agente não precise.
Use quando:
- "Pré-selecione três agências de branding B2B na Califórnia"
- "Encontre uma agência de PPC com experiência em ecommerce"
- "Precisamos de um parceiro de marketing de conteúdo para um lançamento de SaaS"
find-seo-agency
Encontre agências de SEO dos EUA — SEO técnico, on-page/off-page, link building, liderado por conteúdo, local, ecommerce, SEO B2B, auditorias. Fixa automaticamente industry:marketing_agency service_provided:seo.
Use quando:
- "Encontre uma agência de SEO no Texas"
- "Pré-selecione três consultorias de SEO técnico para SaaS"
- Frases indiretas: "o tráfego orgânico está estagnado", "melhore nossas classificações no Google"
find-design-agency
Encontre agências de design e criativas dos EUA — design gráfico, UX/UI, design de produto, identidade de marca, embalagem, ilustração, motion design, direção criativa. Fixa automaticamente industry:design_creative. Delega para find-marketing-agency em engajamentos liderados por marketing onde o design é um dos vários serviços, e para find-web-developer quando a entrega é um site construído em vez de ativos de design.
Use quando:
- "Encontre uma agência de design UX/UI para nosso produto SaaS"
- "Pré-selecione três estúdios de identidade de marca em NY para nosso rebranding"
- "Empresa de design de embalagem para um lançamento de CPG"
find-software-developer
Encontre empresas de desenvolvimento de software dos EUA — software personalizado, desenvolvimento web/mobile, backend/API, consultoria DevOps/cloud, integração de sistemas, hospedagem. Fixa automaticamente industry:it_services. Delega para find-web-developer em projetos estritamente de sites/landing pages, e para find-ai-consultancy em trabalho de modelagem de IA/ML e engenharia de dados.
Use quando:
- "Encontre uma empresa de desenvolvimento de software em Austin"
- "Pré-selecione três empresas de software personalizado com experiência em saúde"
- "Precisamos de um desenvolvedor de aplicativo mobile para nosso lançamento iOS"
find-web-developer
Encontre empresas de desenvolvimento web dos EUA — criação, atualização ou reconstrução de sites de marketing, landing pages, ecommerce, WordPress/Webflow/Shopify, CMS headless, microsites e trabalho de frontend web. Fixa automaticamente industry:it_services service_provided:web-development. Delega para find-software-developer em trabalho de backend/API/mobile, e para find-marketing-agency quando o escopo abrange marketing mais amplo.
Use quando:
- "Encontre um desenvolvedor web para nossa landing page de marketing"
- "Pré-selecione três agências Webflow na Califórnia"
- "Reconstrua nosso site de ecommerce no Shopify com tema personalizado"
find-ai-consultancy
Encontre empresas de consultoria em IA/ML e dados dos EUA — desenvolvimento de IA/ML, MLOps, IA generativa / aplicativos de LLM (RAG, chatbots, agentes), visão computacional, PLN, sistemas de recomendação, engenharia de dados, BI/analytics. Fixa automaticamente industry:data_ai_consulting. Delega para find-software-developer em trabalho geral de aplicativos/backend onde a IA é apenas um recurso.
Use quando:
- "Encontre uma empresa de consultoria em IA/ML para construir nosso mecanismo de recomendação"
- "Três consultorias de RAG/LLM para um projeto de chatbot empresarial"
- Indireto: "queremos usar IA para prever churn de clientes — quem pode ajudar?"
find-law-firm
Encontre escritórios de advocacia B2B dos EUA — direito corporativo, propriedade intelectual/patentes, M&A e valores mobiliários, trabalhista, litígios comerciais, regulatório/conformidade, privacidade de dados/cibersegurança, imobiliário, tributário. Fixa automaticamente industry:legal. O catálogo é exclusivamente B2B — questões pessoais de consumo (divórcio, danos pessoais, defesa criminal, planejamento sucessório, direito de família, testamentos) estão explicitamente fora do escopo.
Use quando:
- "Encontre três escritórios boutique de propriedade intelectual na Califórnia para prosseguimento de patentes"
- "Pré-selecione assessoria de M&A para uma captação Série B"
- Indireto: "assessoria externa para supervisão de GDPR / SOC 2"
find-cpa-firm
Encontre empresas de contabilidade e tributação dos EUA (firmas de CPA) — auditoria de demonstrações financeiras, SOC 1/2, imposto corporativo, contabilidade para empresas, consultoria/CFO fracionado, due diligence de M&A, avaliações 409A, créditos fiscais de P&D, prontidão para IPO, imposto sobre vendas e uso. Fixa automaticamente industry:accounting_tax. Exclusivamente B2B — preparação de imposto pessoal (1040, patrimônio individual, planejamento de aposentadoria) está fora do escopo.
Use quando:
- "Encontre uma firma de CPA para a auditoria Série A da nossa C-corp em Delaware"
- "Pré-selecione três firmas de auditoria com experiência em SaaS"
- Indireto: "nossos livros estão uma bagunça e precisamos de alguém para organizá-los antes da auditoria"
find-management-consultant
Encontre consultorias de gestão dos EUA — estratégia, operações, coaching executivo, desenvolvimento de liderança, desenvolvimento organizacional/gestão de mudanças, PMO/gestão de programas, operações de vendas/receita. Fixa automaticamente industry:management_consulting e usa os sub-tags service_provided (strategy-consulting, operations-consulting, etc.).
Use quando:
- "Encontre três consultorias de estratégia de topo na Califórnia para um SaaS Série B"
- "Precisamos de um coach executivo para nosso novo CEO"
- Indireto: "parceiros de gestão de mudanças para uma integração pós-fusão"
find-engineering-firm
Encontre empresas de engenharia do mundo real dos EUA — civil, estrutural, MEP, mecânica, elétrica, geotécnica, transporte, ambiental, manufatura. Fixa automaticamente industry:engineering_services. NÃO é para engenharia de software — delega pedidos de desenvolvimento de software / "equipe de engenharia" / arquitetura de SaaS para find-software-developer. Ignora pedidos de arquitetura residencial ou de consumo.
Use quando:
- "Encontre empresas de engenharia civil na Flórida para infraestrutura de transporte"
- "Pré-selecione três empresas de engenharia estrutural com experiência em arranha-céus"
- Indireto: "estamos construindo um prédio de 10 andares e precisamos de um engenheiro estrutural para carimbar os desenhos"
find-recruiting-firm
Encontre empresas de recrutamento e staffing dos EUA — busca executiva/busca retida, RPO, recrutamento de tecnologia/vendas/saúde, staffing contingente/contrato, staffing temporário. Fixa automaticamente industry:hr_recruiting_staffing. Contrata uma empresa de recrutamento externa — NÃO dispara em pedidos de contratação de funcionário ("contrate um recrutador para nossa equipe", "onde devo publicar a vaga"), pedidos do lado do candidato ou contratações de recrutadores internos.
Use quando:
- "Encontre uma empresa de busca executiva para uma busca de CFO"
- "Precisamos de suporte RPO para uma contratação de 50 engenheiros"
- Indireto: "estamos crescendo rápido e precisamos de ajuda para contratar em escala"
find-pr-agency
Encontre agências de relações públicas e comunicação dos EUA — relações com a mídia, comunicação de crise, relações com investidores (RI), RP de lançamento de produto, RP de tecnologia/startups, RP de saúde, RP B2B, assuntos públicos, reputação de marca, comunicação interna. Fixa service_provided:public-relations. Delega para find-marketing-agency quando o escopo abrange marketing mais amplo além de RP/comunicação.
Use quando:
- "Encontre uma agência de RP de tecnologia em NY para nosso anúncio da Série B"
- "Três firmas de RI para nosso roadshow de IPO"
- Indireto: "precisamos de imprensa — coloque-nos no TechCrunch, WSJ, na imprensa especializada"
find-cybersecurity-firm
Encontre empresas de segurança cibernética dos EUA — teste de penetração/red team, auditorias de segurança, vCISO, prontidão para SOC 2, resposta a incidentes, SOC gerenciado, IAM, segurança em nuvem, AppSec. Fixa service_provided:cybersecurity. Exclusivamente B2B — segurança cibernética pessoal de consumo ("meu Gmail foi hackeado", "proteja meu wifi doméstico") está fora do escopo.
Use quando:
- "Encontre uma empresa de teste de penetração para nossa auditoria SOC 2"
- "Precisamos de um retainer de resposta a incidentes"
- Indireto: "fomos atingidos por ransomware na semana passada — precisamos de ajuda rápido"
Conjunto de dados de diretórios de produtos
Cada linha é um diretório ao qual você se submete — não é uma empresa e não é um produto. Estas skills respondem onde lançar um produto de software e ganhar backlinks: elas classificam sites de listagem por Domain Rating (grátis em todos os resultados, então você pré-seleciona por zero créditos) e desbloqueiam a nota de submissão (como submeter e se a listagem concede um backlink) além do tráfego orgânico com créditos. Catálogo global, não apenas EUA.
find-product-directories — o guarda-chuva
Encontre e classifique diretórios para submeter um SaaS, produto de software, app ou
startup — sites de avaliação de SaaS, plataformas de lançamento (Product Hunt e suas
alternativas) e diretórios gerais de software. Delega a
find-mcp-directories e find-ai-directories para esses nichos.
Use quando:
- "Onde posso submeter meu SaaS B2B para ganhar backlinks e tráfego no dia do lançamento?"
- "Me dê uma lista de alternativas ao Product Hunt para lançar nosso app"
- "Aqui estão 10 domínios de diretórios de software — obtenha os detalhes de submissão e classifique por DR"
find-mcp-directories
Encontre e classifique registros de servidores MCP (Model Context Protocol) — onde publicar um servidor para que criadores de agentes o descubram, classificados por autoridade de domínio.
Use quando:
- "Onde listo meu servidor MCP?"
- "Melhores diretórios e registros MCP para submeter nosso servidor e ganhar backlinks"
- Indireto: "acabamos de construir um servidor MCP — onde o publicamos?"
find-ai-directories
Encontre e classifique diretórios para ferramentas de IA, agentes de IA e skills/plugins
de agentes — onde listar um produto de IA para ganhar backlinks e descoberta. Delega a
find-mcp-directories quando o artefato for especificamente um servidor MCP.
Use quando:
- "Onde posso listar minha ferramenta de IA para ganhar backlinks e descoberta?"
- "Diretórios para submeter meu agente de IA / onde publico nossa skill de agente?"
- "Classifique os principais diretórios de ferramentas de IA por domain rating para nosso esforço de SEO"
Prefere MCP? Use o servidor hospedado.
Se o seu harness fala o Model Context Protocol, pule a instalação da skill e aponte-o para o servidor MCP hospedado:
https://mcp.servicegraph.co
- Transporte: HTTP Streamable
- Auth: OAuth 2.1 + PKCE com Dynamic Client Registration — seu harness
abre uma aba do navegador no primeiro uso; você faz login em
servicegraph.coe é redirecionado de volta. Sem client ID ou secret para copiar, sem API key para colar.
Claude Code
claude mcp add --transport http servicegraph https://mcp.servicegraph.co
Claude Desktop
Settings → Connectors → Add custom connector, depois cole:
https://mcp.servicegraph.co
O handshake OAuth roda no seu navegador no primeiro uso.
Codex CLI
~/.codex/config.toml:
[mcp_servers.servicegraph]
url = "https://mcp.servicegraph.co"
Cursor e outros clientes com configuração JSON
.cursor/mcp.json (ou o equivalente para o seu harness):
{
"mcpServers": {
"servicegraph": {
"url": "https://mcp.servicegraph.co"
}
}
}
Uso
As skills ficam automaticamente disponíveis após a instalação. O agente escolherá a skill certa quando detectar uma tarefa relevante.
Exemplos:
Find me three boutique IP law firms in California that handle patent
prosecution for hardware startups.
Need a shortlist of mid-size SEO agencies in NY or NJ with a strong B2B
SaaS portfolio.
We're hiring a CPA firm for a Delaware C-corp Series A audit.
Recommend 5 options under 50 people.
Here are 12 marketing agency domains I scraped — pull contact info and
confirm which are in the US.
Como funciona — navegue grátis, desbloqueie com créditos
Cada conjunto de dados vive atrás do mesmo formato de URL por conjunto e do mesmo
DSL de filtro. Para o conjunto de dados de agências, o id é pro_services:
GET /v1/datasets/pro_services/fields → field catalog + DSL grammar · free
GET /v1/datasets/pro_services/check → validate a filter · free
GET /v1/datasets/pro_services/search → brief firm cards · free
GET /v1/datasets/pro_services/{apex} → one row (brief; detail if unlocked) · free
POST /v1/datasets/pro_services/unlocks → full contact bundle · 10 credits/row
Descoberta, filtragem e cards resumidos são gratuitos — você só gasta créditos para desbloquear os detalhes completos de contato de uma linha (URL, telefone, e-mail, redes sociais, endereço). Um desbloqueio dura 30 dias e buscar novamente dentro dessa janela é gratuito.
- 2.000 créditos grátis no cadastro, sem cartão.
- 10 créditos por linha (~US$ 0,10). Recargas: US$ 10 / 1.000 créditos, US$ 80 / 10.000 (20% de desconto). Créditos nunca expiram.
DSL de filtro
Um parâmetro de consulta, no estilo GitHub-search. AND tem precedência sobre OR;
-x / NOT x para negação; tag@evidence para o campo service_provided.
Qualquer palavra isolada é uma busca de texto livre em nome da empresa, marca, título,
meta description e nome legal.
industry:legal state:CA,NY -company_size_signal:solo
industry:management_consulting service_provided:strategy-consulting@high
dental industry:marketing_agency
rating>=4 review_count_total>=20 has:clutch
(web3 OR blockchain) state:CA
O catálogo de campos (tipos, operadores, valores permitidos) é descoberto em tempo
de execução via
/v1/datasets/pro_services/fields.
Por que estruturado é melhor que busca
- Filtre, não faça grep. Indústria, serviços, localização, tamanho, avaliação, autoridade de domínio, tráfego, listagens de terceiros — tudo consultável em uma única string de filtro, não uma parede de resultados web difusos.
- Métricas embutidas. Cada linha contém os sinais que você teria que extrair manualmente — avaliações de agências, DR/tráfego de diretórios, contagens de assinantes de newsletters — para que um agente possa classificar, não apenas listar.
- Mais barato que scraping. Navegue e filtre grátis; pague apenas pelas linhas de contato que você realmente quer, ~US$ 0,10 cada, acesso por 30 dias, créditos nunca expiram. Supera Google, palpites do ChatGPT e listas desatualizadas de Notion/Twitter.
Estrutura da skill
Cada skill segue o Agent Skills Open Standard:
SKILL.md— manifest obrigatório com frontmatter (nome, descrição, metadados)
As skills neste repositório são de arquivo único. Sem scripts ou referências embutidas ainda — a API é pequena o suficiente para que o agente se saia bem com prosa + exemplos curl copiáveis e coláveis.
Links
Comunidade
Veja também
Licença
MIT