The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Servicegraph listing page.
Datasets for founders — where to launch, who to email, who to hire.
Agent Skills for ServiceGraph — structured, metrics-enriched business datasets your agent can filter, rank, and pull contact data from. One filter DSL, one credit balance, many datasets:
| Dataset | Size | Enriched with |
|---|---|---|
| Agencies (US professional-services firms) | 110k+ | services · size · location · ratings |
| Business directories | 3,500+ | industry · domain rating · traffic |
| Product directories | 850+ | submission policy · domain rating · traffic |
| Newsletters | 50k+ | subscribers · topics · post cadence |
| subreddits, influencers | coming soon |
The branded servicegraph skill works against every dataset — say
"servicegraph" and your agent discovers what datasets exist, learns each
one's schema and filters, searches free, and unlocks detail with credits.
The specific find-* skills cover two datasets today. For the Agencies
dataset — law, marketing, design, consulting, accounting, IT services, AI/ML,
web development, engineering, HR, PR, cybersecurity, and more — filterable by
industry, services, location, size, ratings, and third-party listings. And for
the Product directories dataset — where to launch a software product and
earn backlinks — covering general product/SaaS launches, MCP-server
registries, and AI-tool / AI-agent / agent-skill directories, ranked by Domain
Rating and organic traffic. More per-use-case skills for the newsletter and
other datasets land here as they ship — same install, same API key, same DSL.
Compatible with 19+ AI agents including Claude Code, Codex, Cursor, GitHub Copilot, Gemini, Cline, Goose, Windsurf, and any other harness that supports the Agent Skills format.
API key: browsing, filtering, and brief cards are free, but every call
needs a key. Create one at
servicegraph.co/profile/api-keys
(2,000 free credits on signup, no card) and put it in your shell or
.env.local as SERVICEGRAPH_API_KEY=vk_…. Skills prompt for it on first
use and never read the value into the model's context.
The generic, dataset-agnostic way to drive ServiceGraph. Launch it by naming the brand; it discovers what datasets exist and each one's schema and filters through the API, searches free brief rows, and unlocks contact + metric detail with credits — no datasets or fields hardcoded, so it stays correct as new data lands.
Use when:
Find, shortlist, vet, or enrich US professional-services firms across all 22 industries in the catalog — law, marketing, consulting, accounting, IT services, architecture, engineering, HR, PR, design, and more.
Use when:
Find US marketing agencies — branding, content marketing, PPC/paid media,
social, email, performance/demand-gen, video production, full-service digital.
Auto-pins industry:marketing_agency so the agent doesn't have to.
Use when:
Find US SEO agencies — technical, on-page/off-page, link-building,
content-led, local, ecommerce, B2B SEO, audits. Auto-pins
industry:marketing_agency service_provided:seo.
Use when:
Find US design and creative agencies — graphic design, UX/UI, product
design, brand identity, packaging, illustration, motion design, creative
direction. Auto-pins industry:design_creative. Defers to
find-marketing-agency for marketing-led engagements where design is one
of several services, and to find-web-developer when the deliverable is a
built website rather than design assets.
Use when:
Find US software development firms — custom software, web/mobile development,
backend/API, DevOps/cloud consulting, system integration, hosting. Auto-pins
industry:it_services. Defers to find-web-developer for strictly
website/landing-page projects, and to find-ai-consultancy for AI/ML
modeling and data-engineering work.
Use when:
Find US web development firms — building, refreshing, or rebuilding
marketing sites, landing pages, ecommerce, WordPress/Webflow/Shopify,
headless CMS, microsites, and web frontend work. Auto-pins
industry:it_services service_provided:web-development. Defers to
find-software-developer for backend/API/mobile work, and to
find-marketing-agency when scope spans broader marketing.
Use when:
Find US AI/ML and data consulting firms — AI/ML development, MLOps,
generative AI / LLM apps (RAG, chatbots, agents), computer vision, NLP,
recommendation systems, data engineering, BI/analytics. Auto-pins
industry:data_ai_consulting. Defers to find-software-developer for
general app/backend work where AI is just a feature.
Use when:
Find US B2B law firms — corporate, IP/patent, M&A and securities,
employment, commercial litigation, regulatory/compliance, data privacy/
cyber, real estate, tax. Auto-pins industry:legal. The catalog is
B2B-only — consumer-personal matters (divorce, personal injury, criminal
defense, estate planning, family law, wills) are explicitly out of scope.
Use when:
Find US accounting and tax firms (CPA firms) — financial-statement audit,
SOC 1/2, corporate tax, bookkeeping for businesses, advisory/fractional
CFO, M&A diligence, 409A valuations, R&D tax credits, IPO readiness,
sales-and-use tax. Auto-pins industry:accounting_tax. B2B-only —
personal tax prep (1040, individual estate, retirement planning) is
out of scope.
Use when:
Find US management consultancies — strategy, operations, executive
coaching, leadership development, org-development/change management,
PMO/program management, sales/revenue ops. Auto-pins
industry:management_consulting and uses the service_provided
sub-tags (strategy-consulting, operations-consulting, etc.).
Use when:
Find US real-world engineering firms — civil, structural, MEP,
mechanical, electrical, geotechnical, transportation, environmental,
manufacturing. Auto-pins industry:engineering_services. NOT for
software engineering — defers software-dev / "engineering team" /
SaaS-architecture asks to find-software-developer. Skips residential
or consumer architecture asks.
Use when:
Find US recruiting and staffing firms — executive search/retained search,
RPO, tech/sales/healthcare recruiting, contingent/contract staffing, temp
staffing. Auto-pins industry:hr_recruiting_staffing. Procures an
external recruiting firm — does NOT fire on recruiting-an-employee
asks ("hire a recruiter for our team", "where should I post the job"),
candidate-side asks, or in-house recruiter hires.
Use when:
Find US public-relations and communications agencies — media relations,
crisis comms, investor relations (IR), product-launch PR, tech/startup
PR, healthcare PR, B2B PR, public affairs, brand reputation, internal
communications. Pins service_provided:public-relations. Defers to
find-marketing-agency when scope spans broader marketing beyond
PR/comms.
Use when:
Find US cybersecurity firms — pen-testing/red team, security audits,
vCISO, SOC 2 readiness, incident response, managed SOC, IAM, cloud
security, AppSec. Pins service_provided:cybersecurity. B2B-only
— consumer-personal cybersecurity ("my Gmail got hacked", "secure my
home wifi") is out of scope.
Use when:
Each row is a directory you submit to — not a firm and not a product. These skills answer where to launch a software product and earn backlinks: they rank listing sites by Domain Rating (free in every result, so you shortlist for zero credits) and unlock the submission note (how to submit, and whether the listing grants a backlink) plus organic traffic with credits. Global catalog, not US-only.
Find and rank directories to submit a SaaS, software product, app, or
startup to — SaaS review sites, launch platforms (Product Hunt and its
alternatives), and general software directories. Defers to
find-mcp-directories and find-ai-directories for those niches.
Use when:
Find and rank MCP-server registries (Model Context Protocol) — where to publish a server so agent builders discover it, ranked by domain authority.
Use when:
Find and rank directories for AI tools, AI agents, and agent skills /
plugins — where to list an AI product for backlinks and discovery. Defers to
find-mcp-directories when the artifact is specifically an MCP server.
Use when:
If your harness speaks the Model Context Protocol, skip the skill install and point it at the hosted MCP server:
servicegraph.co and are
bounced back. No client ID or secret to copy around, no API key to paste.Settings → Connectors → Add custom connector, then paste:
The OAuth handshake runs in your browser on first use.
~/.codex/config.toml:
.cursor/mcp.json (or the equivalent for your harness):
Skills are automatically available once installed. The agent will pick the right one when it detects a relevant task.
Examples:
Every dataset lives behind the same per-dataset URL shape and the same
filter DSL. For the agencies dataset the id is pro_services:
Discovery, filtering, and brief cards are free — you only spend credits to unlock a row's full contact detail (URL, phone, email, social, address). An unlock lasts 30 days and re-fetching within that window is free.
One query parameter, GitHub-search-style. AND binds tighter than OR;
-x / NOT x for negation; tag@evidence for the service_provided field.
Any bareword is a free-text keyword search across firm name, brand, title,
meta description, and legal name.
The field catalog (kinds, operators, allowed values) is discoverable at
runtime via
/v1/datasets/pro_services/fields.
Each skill follows the Agent Skills Open Standard:
SKILL.md — required manifest with frontmatter (name, description, metadata)The skills in this repo are single-file. No bundled scripts or references yet — the API is small enough that the agent does fine with prose + copy-pasteable curl examples.
MIT