ServiceGraph Agent Skills

Stop scraping. Your agent's directory of US service firms is here.

Agent Skills that drive the ServiceGraph API
— a structured catalog of 100k+ US professional-services firms (law,
marketing, consulting, accounting, IT services, architecture, engineering, HR,
PR, design) with filters for industry, services offered, location, size,
ratings, and third-party listing presence.

Each skill is a packaged set of instructions that teaches an AI agent how to
walk the four-tier funnel — tags → explore → search → get — so it can
shortlist and enrich firms without burning quota or scraping the web.

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.

Installation

Install a specific skill

npx skills add nostrband/servicegraph --skill find-service-providers

Install all skills

npx skills add nostrband/servicegraph

No signup is needed for catalog discovery (/v1/tags, /v1/check,
/v1/explore). Skills prompt the user for an email + one-time code only when
they reach the contact-info tier (/v1/search, /v1/get).

Available Skills

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 me three boutique IP law firms in California"
• "Build a longlist of 50 mid-size US management consultancies"
• "Here are 12 agency domains — pull contact info and confirm which are US-based"
• The user's intent doesn't fit a more specific skill below

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:

• "Shortlist three B2B branding agencies in California"
• "Find a PPC shop with ecommerce experience"
• "We need a content marketing partner for a SaaS launch"

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 me an SEO agency in Texas"
• "Shortlist three technical SEO consultancies for SaaS"
• Indirect phrasings: "organic traffic is flat", "improve our Google rankings"

Find US software development firms — custom software, web/mobile development,
backend/API, DevOps, cloud consulting, system integration, hosting, managed
IT. Auto-pins industry:it_services.

Use when:

• "Find me a software dev shop in Austin"
• "Shortlist three custom-software firms with healthcare experience"
• "We need a mobile app developer for our iOS launch"

Coming soon

Industry-specific skills are rolling out to bring the catalog's 22 industries
to first-class coverage — find-web-developer, find-law-firm,
find-consulting-firm, find-accounting-firm, find-pr-agency, and more.
Until they ship, the umbrella find-service-providers skill handles every
industry through the same DSL.

Usage

Skills are automatically available once installed. The agent will pick the
right one when it detects a relevant task.

Examples:

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.

How it works — the four-tier funnel

GET /v1/tags         →  field catalog · free · anonymous
GET /v1/check        →  validate filter · free · anonymous
GET /v1/explore      →  counts + breakdowns · free · anonymous
GET /v1/search       →  brief firm cards · 200/month free
GET /v1/get/{id}     →  full bundle (url, phone, email) · 50/month free

Skills know to walk down the funnel: cheap tiers first, expensive tiers only
on shortlisted firms. Re-pages and overlapping queries are free — the quota
counts only unique firm-views per calendar month.

Filter DSL

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.

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

Field catalog (kinds, operators, allowed values) is discoverable at runtime
via /v1/tags.

Why structured beats search

• Filter, don't grep. Industry, services, location, size, rating,
  third-party listings — all queryable as a single filter string. Not a wall
  of fuzzy web results.
• Try before you sign up. /v1/explore is fully anonymous. Get counts
  and breakdowns for any filter to size the candidate pool before spending an
  API call.
• Quota rewards focus. 200 unique firm-views per month free. Re-paging
  or overlapping queries are free; only new firms count.

Skill structure

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.

Links

• API console & docs
• OpenAPI 3.1 spec
• Field catalog — live list of every
  filterable field, kind, and allowed value
• llms.txt
• Site

License

MIT

Contact

[email protected]