{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/mark-128.png\" alt=\"ServiceGraph\" width=\"64\" height=\"64\" />\n</p>\n\n# ServiceGraph Agent Skills\n\n> **Datasets for founders** — where to launch, who to email, who to hire.\n\nAgent Skills for [**ServiceGraph**](https://servicegraph.co) — structured,\nmetrics-enriched business datasets your agent can filter, rank, and pull\ncontact data from. One filter DSL, one credit balance, many datasets:\n\n<p align=\"center\">\n  <img src=\"assets/servicegraph-datasets.png\" alt=\"ServiceGraph datasets — product directories, business directories, newsletters, agencies, with subreddits and influencers coming soon\" width=\"820\" />\n</p>\n\n| Dataset | Size | Enriched with |\n|---|---|---|\n| **Agencies** (US professional-services firms) | 110k+ | services · size · location · ratings |\n| **Business directories** | 3,500+ | industry · domain rating · traffic |\n| **Product directories** | 850+ | submission policy · domain rating · traffic |\n| **Newsletters** | 50k+ | subscribers · topics · post cadence |\n| _subreddits, influencers_ | _coming soon_ | |\n\n**The branded `servicegraph` skill works against every dataset** — say\n\"servicegraph\" and your agent discovers what datasets exist, learns each\none's schema and filters, searches free, and unlocks detail with credits.\n**The specific `find-*` skills cover two datasets today.** For the **Agencies**\ndataset — law, marketing, design, consulting, accounting, IT services, AI/ML,\nweb development, engineering, HR, PR, cybersecurity, and more — filterable by\nindustry, services, location, size, ratings, and third-party listings. And for\nthe **Product directories** dataset — where to *launch* a software product and\n*earn backlinks* — covering general product/SaaS launches, MCP-server\nregistries, and AI-tool / AI-agent / agent-skill directories, ranked by Domain\nRating and organic traffic. More per-use-case skills for the newsletter and\nother datasets land here as they ship — same install, same API key, same DSL.\n\nCompatible with **19+ AI agents** including Claude Code, Codex, Cursor, GitHub\nCopilot, Gemini, Cline, Goose, Windsurf, and any other harness that supports\nthe [Agent Skills](https://agentskills.io/) format.\n\n## Installation\n\n### Install a specific skill\n\n```bash\nnpx skills add nostrband/servicegraph --skill find-service-providers\n```\n\n### Install all skills\n\n```bash\nnpx skills add nostrband/servicegraph\n```\n\n**API key:** browsing, filtering, and brief cards are free, but every call\nneeds a key. Create one at\n[**servicegraph.co/profile/api-keys**](https://servicegraph.co/profile/api-keys)\n(2,000 free credits on signup, no card) and put it in your shell or\n`.env.local` as `SERVICEGRAPH_API_KEY=vk_…`. Skills prompt for it on first\nuse and never read the value into the model's context.\n\n## Available Skills\n\n### Any dataset\n\n<details open>\n<summary><strong>servicegraph</strong> — the branded entry point</summary>\n\nThe generic, dataset-agnostic way to drive ServiceGraph. Launch it by naming\nthe brand; it discovers what datasets exist and each one's schema and filters\nthrough the API, searches free brief rows, and unlocks contact + metric detail\nwith credits — no datasets or fields hardcoded, so it stays correct as new\ndata lands.\n\n**Use when:**\n- \"Use ServiceGraph to find …\"\n- \"What datasets does ServiceGraph have?\"\n- \"Search ServiceGraph for … / look this up in ServiceGraph\"\n- \"Pull contacts from ServiceGraph for these domains\"\n- The dataset you need has no specific skill below yet\n\n</details>\n\n### Agencies dataset\n\n<details open>\n<summary><strong>find-service-providers</strong> — the umbrella skill</summary>\n\nFind, shortlist, vet, or enrich US professional-services firms across all 22\nindustries in the catalog — law, marketing, consulting, accounting, IT\nservices, architecture, engineering, HR, PR, design, and more.\n\n**Use when:**\n- \"Find me three boutique IP law firms in California\"\n- \"Build a longlist of 50 mid-size US management consultancies\"\n- \"Here are 12 agency domains — pull contact info and confirm which are US-based\"\n- The user's intent doesn't fit a more specific skill below\n\n</details>\n\n<details>\n<summary><strong>find-marketing-agency</strong></summary>\n\nFind US marketing agencies — branding, content marketing, PPC/paid media,\nsocial, email, performance/demand-gen, video production, full-service digital.\nAuto-pins `industry:marketing_agency` so the agent doesn't have to.\n\n**Use when:**\n- \"Shortlist three B2B branding agencies in California\"\n- \"Find a PPC shop with ecommerce experience\"\n- \"We need a content marketing partner for a SaaS launch\"\n\n</details>\n\n<details>\n<summary><strong>find-seo-agency</strong></summary>\n\nFind US SEO agencies — technical, on-page/off-page, link-building,\ncontent-led, local, ecommerce, B2B SEO, audits. Auto-pins\n`industry:marketing_agency service_provided:seo`.\n\n**Use when:**\n- \"Find me an SEO agency in Texas\"\n- \"Shortlist three technical SEO consultancies for SaaS\"\n- Indirect phrasings: \"organic traffic is flat\", \"improve our Google rankings\"\n\n</details>\n\n<details>\n<summary><strong>find-design-agency</strong></summary>\n\nFind US design and creative agencies — graphic design, UX/UI, product\ndesign, brand identity, packaging, illustration, motion design, creative\ndirection. Auto-pins `industry:design_creative`. Defers to\n`find-marketing-agency` for marketing-led engagements where design is one\nof several services, and to `find-web-developer` when the deliverable is a\nbuilt website rather than design assets.\n\n**Use when:**\n- \"Find me a UX/UI design agency for our SaaS product\"\n- \"Shortlist three brand-identity studios in NY for our rebrand\"\n- \"Packaging design firm for a CPG launch\"\n\n</details>\n\n<details>\n<summary><strong>find-software-developer</strong></summary>\n\nFind US software development firms — custom software, web/mobile development,\nbackend/API, DevOps/cloud consulting, system integration, hosting. Auto-pins\n`industry:it_services`. Defers to `find-web-developer` for strictly\nwebsite/landing-page projects, and to `find-ai-consultancy` for AI/ML\nmodeling and data-engineering work.\n\n**Use when:**\n- \"Find me a software dev shop in Austin\"\n- \"Shortlist three custom-software firms with healthcare experience\"\n- \"We need a mobile app developer for our iOS launch\"\n\n</details>\n\n<details>\n<summary><strong>find-web-developer</strong></summary>\n\nFind US web development firms — building, refreshing, or rebuilding\nmarketing sites, landing pages, ecommerce, WordPress/Webflow/Shopify,\nheadless CMS, microsites, and web frontend work. Auto-pins\n`industry:it_services service_provided:web-development`. Defers to\n`find-software-developer` for backend/API/mobile work, and to\n`find-marketing-agency` when scope spans broader marketing.\n\n**Use when:**\n- \"Find a web developer for our marketing landing page\"\n- \"Shortlist three Webflow agencies in California\"\n- \"Rebuild our ecommerce site on Shopify with custom theme work\"\n\n</details>\n\n<details>\n<summary><strong>find-ai-consultancy</strong></summary>\n\nFind US AI/ML and data consulting firms — AI/ML development, MLOps,\ngenerative AI / LLM apps (RAG, chatbots, agents), computer vision, NLP,\nrecommendation systems, data engineering, BI/analytics. Auto-pins\n`industry:data_ai_consulting`. Defers to `find-software-developer` for\ngeneral app/backend work where AI is just a feature.\n\n**Use when:**\n- \"Find an AI/ML consulting firm to build our recommendation engine\"\n- \"Three RAG/LLM consultancies for an enterprise chatbot project\"\n- Indirect: \"we want to use AI to predict customer churn — who can help?\"\n\n</details>\n\n<details>\n<summary><strong>find-law-firm</strong></summary>\n\nFind US **B2B** law firms — corporate, IP/patent, M&A and securities,\nemployment, commercial litigation, regulatory/compliance, data privacy/\ncyber, real estate, tax. Auto-pins `industry:legal`. The catalog is\nB2B-only — consumer-personal matters (divorce, personal injury, criminal\ndefense, estate planning, family law, wills) are explicitly out of scope.\n\n**Use when:**\n- \"Find three boutique IP law firms in California for patent prosecution\"\n- \"Shortlist M&A counsel for a Series-B fundraise\"\n- Indirect: \"outside counsel for GDPR / SOC 2 oversight\"\n\n</details>\n\n<details>\n<summary><strong>find-cpa-firm</strong></summary>\n\nFind US accounting and tax firms (CPA firms) — financial-statement audit,\nSOC 1/2, corporate tax, bookkeeping for businesses, advisory/fractional\nCFO, M&A diligence, 409A valuations, R&D tax credits, IPO readiness,\nsales-and-use tax. Auto-pins `industry:accounting_tax`. B2B-only —\npersonal tax prep (1040, individual estate, retirement planning) is\nout of scope.\n\n**Use when:**\n- \"Find me a CPA firm for our Delaware C-corp Series A audit\"\n- \"Shortlist three audit firms with SaaS experience\"\n- Indirect: \"our books are a mess and we need someone to clean them up\n  before the audit\"\n\n</details>\n\n<details>\n<summary><strong>find-management-consultant</strong></summary>\n\nFind US management consultancies — strategy, operations, executive\ncoaching, leadership development, org-development/change management,\nPMO/program management, sales/revenue ops. Auto-pins\n`industry:management_consulting` and uses the `service_provided`\nsub-tags (`strategy-consulting`, `operations-consulting`, etc.).\n\n**Use when:**\n- \"Find me three top strategy consultancies in California for a Series-B SaaS\"\n- \"We need an executive coach for our new CEO\"\n- Indirect: \"change-management partners for a post-merger integration\"\n\n</details>\n\n<details>\n<summary><strong>find-engineering-firm</strong></summary>\n\nFind US **real-world** engineering firms — civil, structural, MEP,\nmechanical, electrical, geotechnical, transportation, environmental,\nmanufacturing. Auto-pins `industry:engineering_services`. **NOT for\nsoftware engineering** — defers software-dev / \"engineering team\" /\nSaaS-architecture asks to `find-software-developer`. Skips residential\nor consumer architecture asks.\n\n**Use when:**\n- \"Find civil engineering firms in Florida for transportation infrastructure\"\n- \"Shortlist three structural engineering firms with high-rise experience\"\n- Indirect: \"we're building a 10-story office and need a structural engineer\n  to stamp the drawings\"\n\n</details>\n\n<details>\n<summary><strong>find-recruiting-firm</strong></summary>\n\nFind US recruiting and staffing firms — executive search/retained search,\nRPO, tech/sales/healthcare recruiting, contingent/contract staffing, temp\nstaffing. Auto-pins `industry:hr_recruiting_staffing`. **Procures an\nexternal recruiting firm** — does NOT fire on recruiting-an-employee\nasks (\"hire a recruiter for our team\", \"where should I post the job\"),\ncandidate-side asks, or in-house recruiter hires.\n\n**Use when:**\n- \"Find me an executive search firm for a CFO search\"\n- \"We need RPO support for a 50-engineer hiring push\"\n- Indirect: \"we're scaling fast and need help hiring at scale\"\n\n</details>\n\n<details>\n<summary><strong>find-pr-agency</strong></summary>\n\nFind US public-relations and communications agencies — media relations,\ncrisis comms, investor relations (IR), product-launch PR, tech/startup\nPR, healthcare PR, B2B PR, public affairs, brand reputation, internal\ncommunications. Pins `service_provided:public-relations`. Defers to\n`find-marketing-agency` when scope spans broader marketing beyond\nPR/comms.\n\n**Use when:**\n- \"Find me a tech PR agency in NY for our Series-B announcement\"\n- \"Three IR firms for our upcoming IPO roadshow\"\n- Indirect: \"we need press — get us into TechCrunch, WSJ, the trade press\"\n\n</details>\n\n<details>\n<summary><strong>find-cybersecurity-firm</strong></summary>\n\nFind US cybersecurity firms — pen-testing/red team, security audits,\nvCISO, SOC 2 readiness, incident response, managed SOC, IAM, cloud\nsecurity, AppSec. Pins `service_provided:cybersecurity`. B2B-only\n— consumer-personal cybersecurity (\"my Gmail got hacked\", \"secure my\nhome wifi\") is out of scope.\n\n**Use when:**\n- \"Find me a pen-testing firm for our SOC 2 audit\"\n- \"We need an incident response retainer\"\n- Indirect: \"we got hit with ransomware last week — we need help fast\"\n\n</details>\n\n### Product directories dataset\n\nEach row is a **directory you submit to** — not a firm and not a product.\nThese skills answer *where to launch a software product and earn backlinks*:\nthey rank listing sites by **Domain Rating** (free in every result, so you\nshortlist for zero credits) and unlock the **submission note** (how to submit,\nand whether the listing grants a backlink) plus organic traffic with credits.\nGlobal catalog, not US-only.\n\n<details open>\n<summary><strong>find-product-directories</strong> — the umbrella</summary>\n\nFind and rank directories to submit a **SaaS, software product, app, or\nstartup** to — SaaS review sites, launch platforms (Product Hunt and its\nalternatives), and general software directories. Defers to\n`find-mcp-directories` and `find-ai-directories` for those niches.\n\n**Use when:**\n- \"Where can I submit my B2B SaaS to get backlinks and launch-day traffic?\"\n- \"Give me a list of Product Hunt alternatives to launch our app on\"\n- \"Here are 10 software directory domains — pull submission details and rank by DR\"\n\n</details>\n\n<details>\n<summary><strong>find-mcp-directories</strong></summary>\n\nFind and rank **MCP-server registries** (Model Context Protocol) — where to\npublish a server so agent builders discover it, ranked by domain authority.\n\n**Use when:**\n- \"Where do I list my MCP server?\"\n- \"Best MCP directories and registries to submit our server to for backlinks\"\n- Indirect: \"we just built an MCP server — where do we publish it?\"\n\n</details>\n\n<details>\n<summary><strong>find-ai-directories</strong></summary>\n\nFind and rank directories for **AI tools, AI agents, and agent skills /\nplugins** — where to list an AI product for backlinks and discovery. Defers to\n`find-mcp-directories` when the artifact is specifically an MCP server.\n\n**Use when:**\n- \"Where can I list my AI tool to get backlinks and discovery?\"\n- \"Directories to submit my AI agent / where do I publish our agent skill?\"\n- \"Rank the top AI tool directories by domain rating for our SEO push\"\n\n</details>\n\n## Prefer MCP? Use the hosted server.\n\nIf your harness speaks the [Model Context Protocol](https://modelcontextprotocol.io/),\nskip the skill install and point it at the hosted MCP server:\n\n```\nhttps://mcp.servicegraph.co\n```\n\n- **Transport:** Streamable HTTP\n- **Auth:** OAuth 2.1 + PKCE with Dynamic Client Registration — your harness\n  opens a browser tab on first use; you sign in on `servicegraph.co` and are\n  bounced back. No client ID or secret to copy around, no API key to paste.\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http servicegraph https://mcp.servicegraph.co\n```\n\n### Claude Desktop\n\n**Settings → Connectors → Add custom connector**, then paste:\n\n```\nhttps://mcp.servicegraph.co\n```\n\nThe OAuth handshake runs in your browser on first use.\n\n### Codex CLI\n\n`~/.codex/config.toml`:\n\n```toml\n[mcp_servers.servicegraph]\nurl = \"https://mcp.servicegraph.co\"\n```\n\n### Cursor and other JSON-config clients\n\n`.cursor/mcp.json` (or the equivalent for your harness):\n\n```json\n{\n  \"mcpServers\": {\n    \"servicegraph\": {\n      \"url\": \"https://mcp.servicegraph.co\"\n    }\n  }\n}\n```\n\n## Usage\n\nSkills are automatically available once installed. The agent will pick the\nright one when it detects a relevant task.\n\n**Examples:**\n\n```\nFind me three boutique IP law firms in California that handle patent\nprosecution for hardware startups.\n```\n\n```\nNeed a shortlist of mid-size SEO agencies in NY or NJ with a strong B2B\nSaaS portfolio.\n```\n\n```\nWe're hiring a CPA firm for a Delaware C-corp Series A audit.\nRecommend 5 options under 50 people.\n```\n\n```\nHere are 12 marketing agency domains I scraped — pull contact info and\nconfirm which are in the US.\n```\n\n## How it works — browse free, unlock with credits\n\nEvery dataset lives behind the same per-dataset URL shape and the same\nfilter DSL. For the agencies dataset the id is `pro_services`:\n\n```\nGET  /v1/datasets/pro_services/fields    →  field catalog + DSL grammar · free\nGET  /v1/datasets/pro_services/check     →  validate a filter · free\nGET  /v1/datasets/pro_services/search    →  brief firm cards · free\nGET  /v1/datasets/pro_services/{apex}    →  one row (brief; detail if unlocked) · free\nPOST /v1/datasets/pro_services/unlocks   →  full contact bundle · 10 credits/row\n```\n\nDiscovery, filtering, and brief cards are **free** — you only spend credits\nto unlock a row's full contact detail (URL, phone, email, social, address).\nAn unlock lasts **30 days** and re-fetching within that window is free.\n\n- **2,000 free credits on signup**, no card.\n- **10 credits per row** (~$0.10). Top-ups: $10 / 1,000 credits, $80 / 10,000\n  (20% off). **Credits never expire.**\n\n### Filter DSL\n\nOne query parameter, GitHub-search-style. AND binds tighter than OR;\n`-x` / `NOT x` for negation; `tag@evidence` for the `service_provided` field.\nAny bareword is a free-text keyword search across firm name, brand, title,\nmeta description, and legal name.\n\n```\nindustry:legal state:CA,NY -company_size_signal:solo\nindustry:management_consulting service_provided:strategy-consulting@high\ndental industry:marketing_agency\nrating>=4 review_count_total>=20 has:clutch\n(web3 OR blockchain) state:CA\n```\n\nThe field catalog (kinds, operators, allowed values) is discoverable at\nruntime via\n[`/v1/datasets/pro_services/fields`](https://api.servicegraph.co/v1/datasets/pro_services/fields).\n\n## Why structured beats search\n\n- **Filter, don't grep.** Industry, services, location, size, rating,\n  domain authority, traffic, third-party listings — all queryable as a single\n  filter string, not a wall of fuzzy web results.\n- **Metrics built in.** Every row carries the signals you'd otherwise scrape\n  by hand — agency ratings, directory DR/traffic, newsletter subscriber\n  counts — so an agent can rank, not just list.\n- **Cheaper than scraping.** Browse and filter for free; pay only for the\n  contact rows you actually want, ~$0.10 each, 30-day access, credits never\n  expire. Beats Google, ChatGPT guesses, and stale Notion/Twitter lists.\n\n## Skill structure\n\nEach skill follows the [Agent Skills Open Standard](https://agentskills.io/):\n\n- `SKILL.md` — required manifest with frontmatter (name, description, metadata)\n\nThe skills in this repo are single-file. No bundled scripts or references\nyet — the API is small enough that the agent does fine with prose +\ncopy-pasteable curl examples.\n\n## Links\n\n- [API console & docs](https://docs.servicegraph.co)\n- [OpenAPI 3.1 spec](https://api.servicegraph.co/openapi.json)\n- [Create an API key](https://servicegraph.co/profile/api-keys)\n- [llms.txt](https://servicegraph.co/llms.txt)\n- [Site](https://servicegraph.co)\n\n## Community\n\n- [Dev.to](https://dev.to/brugeman)\n- [X.com](https://x.com/briugemanai)\n\n## See also\n\n- [Product directories](https://servicegraph.co/product-directories)\n- [MCP directories](https://servicegraph.co/blog/best-mcp-directories-2026)\n- [Agent skills directories](https://dev.to/brugeman/where-to-publish-your-ai-agent-skills-discovery-hubs-and-directories-5l7)\n- [ProductHunt](https://www.producthunt.com/@arturbrugeman)\n\n## License\n\nMIT\n\n## Contact\n\n[artur@servicegraph.co](mailto:artur@servicegraph.co)\n",
  "bytes": 19214,
  "sha": "9086558e1bcb588dc1b8f1a25e8c41ec23e3f57176d763b5189d58cba997eb0d",
  "repo_slug": "nostrband/servicegraph",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_co_servicegraph_mcp_servicegraph_8beeb7da/readme"
}