nostrband/ServiceGraph

Profil nostrband

Dernière activité source enregistrée: 1 juin 2026 à 10:23

Catalogue SkillsMP mis à jour: 17 octobre 2026 à 00:09

skills collectés: 18

Étoiles GitHub: 61
Forks GitHub: 7

README du dépôt

Fichier source du README : README.md

Lire le README source

Afficher le README complet

<img src="assets/mark-128.png" alt="ServiceGraph" width="64" height="64" /> # ServiceGraph Agent Skills > **Datasets for founders** — where to launch, who to email, who to hire. Agent Skills for [**ServiceGraph**](https://servicegraph.co) — structured, metrics-enriched business datasets your agent can filter, rank, and pull contact data from. One filter DSL, one credit balance, many datasets: <img src="assets/servicegraph-datasets.png" alt="ServiceGraph datasets — product directories, business directories, newsletters, agencies, with subreddits and influencers coming soon" width="820" /> | 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](https://agentskills.io/) format. ## Installation ### Install a specific skill ```bash npx skills add nostrband/servicegraph --skill find-service-providers ``` ### Install all skills ```bash npx skills add nostrband/servicegraph ``` **API key:** browsing, filtering, and brief cards are free, but every call needs a key. Create one at [**servicegraph.co/profile/api-keys**](https://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. ## Available Skills ### Any dataset <details open> <summary>servicegraph — the branded entry point</summary> 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:** - "Use ServiceGraph to find …" - "What datasets does ServiceGraph have?" - "Search ServiceGraph for … / look this up in ServiceGraph" - "Pull contacts from ServiceGraph for these domains" - The dataset you need has no specific skill below yet </details> ### Agencies dataset <details open> <summary>find-service-providers — the umbrella skill</summary> 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 </details> <details> <summary>find-marketing-agency</summary> 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" </details> <details> <summary>find-seo-agency</summary> 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" </details> <details> <summary>find-design-agency</summary> 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 me a UX/UI design agency for our SaaS product" - "Shortlist three brand-identity studios in NY for our rebrand" - "Packaging design firm for a CPG launch" </details> <details> <summary>find-software-developer</summary> 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 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" </details> <details> <summary>find-web-developer</summary> 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 a web developer for our marketing landing page" - "Shortlist three Webflow agencies in California" - "Rebuild our ecommerce site on Shopify with custom theme work" </details> <details> <summary>find-ai-consultancy</summary> 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 an AI/ML consulting firm to build our recommendation engine" - "Three RAG/LLM consultancies for an enterprise chatbot project" - Indirect: "we want to use AI to predict customer churn — who can help?" </details> <details> <summary>find-law-firm</summary> 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 three boutique IP law firms in California for patent prosecution" - "Shortlist M&A counsel for a Series-B fundraise" - Indirect: "outside counsel for GDPR / SOC 2 oversight" </details> <details> <summary>find-cpa-firm</summary> 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 me a CPA firm for our Delaware C-corp Series A audit" - "Shortlist three audit firms with SaaS experience" - Indirect: "our books are a mess and we need someone to clean them up before the audit" </details> <details> <summary>find-management-consultant</summary> 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 me three top strategy consultancies in California for a Series-B SaaS" - "We need an executive coach for our new CEO" - Indirect: "change-management partners for a post-merger integration" </details> <details> <summary>find-engineering-firm</summary> 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 civil engineering firms in Florida for transportation infrastructure" - "Shortlist three structural engineering firms with high-rise experience" - Indirect: "we're building a 10-story office and need a structural engineer to stamp the drawings" </details> <details> <summary>find-recruiting-firm</summary> 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 me an executive search firm for a CFO search" - "We need RPO support for a 50-engineer hiring push" - Indirect: "we're scaling fast and need help hiring at scale" </details> <details> <summary>find-pr-agency</summary> 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 me a tech PR agency in NY for our Series-B announcement" - "Three IR firms for our upcoming IPO roadshow" - Indirect: "we need press — get us into TechCrunch, WSJ, the trade press" </details> <details> <summary>find-cybersecurity-firm</summary> 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:** - "Find me a pen-testing firm for our SOC 2 audit" - "We need an incident response retainer" - Indirect: "we got hit with ransomware last week — we need help fast" </details> ### Product directories dataset 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. <details open> <summary>find-product-directories — the umbrella</summary> 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:** - "Where can I submit my B2B SaaS to get backlinks and launch-day traffic?" - "Give me a list of Product Hunt alternatives to launch our app on" - "Here are 10 software directory domains — pull submission details and rank by DR" </details> <details> <summary>find-mcp-directories</summary> 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:** - "Where do I list my MCP server?" - "Best MCP directories and registries to submit our server to for backlinks" - Indirect: "we just built an MCP server — where do we publish it?" </details> <details> <summary>find-ai-directories</summary> 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:** - "Where can I list my AI tool to get backlinks and discovery?" - "Directories to submit my AI agent / where do I publish our agent skill?" - "Rank the top AI tool directories by domain rating for our SEO push" </details> ## Prefer MCP? Use the hosted server. If your harness speaks the [Model Context Protocol](https://modelcontextprotocol.io/), skip the skill install and point it at the hosted MCP server: ``` https://mcp.servicegraph.co ``` - **Transport:** Streamable HTTP - **Auth:** OAuth 2.1 + PKCE with Dynamic Client Registration — your harness opens a browser tab on first use; you sign in on `servicegraph.co` and are bounced back. No client ID or secret to copy around, no API key to paste. ### Claude Code ```bash claude mcp add --transport http servicegraph https://mcp.servicegraph.co ``` ### Claude Desktop **Settings → Connectors → Add custom connector**, then paste: ``` https://mcp.servicegraph.co ``` The OAuth handshake runs in your browser on first use. ### Codex CLI `~/.codex/config.toml`: ```toml [mcp_servers.servicegraph] url = "https://mcp.servicegraph.co" ``` ### Cursor and other JSON-config clients `.cursor/mcp.json` (or the equivalent for your harness): ```json { "mcpServers": { "servicegraph": { "url": "https://mcp.servicegraph.co" } } } ``` ## 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 — browse free, unlock with credits Every dataset lives behind the same per-dataset URL shape and the same filter DSL. For the agencies dataset the id is `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 ``` 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. - **2,000 free credits on signup**, no card. - **10 credits per row** (~$0.10). Top-ups: $10 / 1,000 credits, $80 / 10,000 (20% off). **Credits never expire.** ### 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 ``` The field catalog (kinds, operators, allowed values) is discoverable at runtime via [`/v1/datasets/pro_services/fields`](https://api.servicegraph.co/v1/datasets/pro_services/fields). ## Why structured beats search - **Filter, don't grep.** Industry, services, location, size, rating, domain authority, traffic, third-party listings — all queryable as a single filter string, not a wall of fuzzy web results. - **Metrics built in.** Every row carries the signals you'd otherwise scrape by hand — agency ratings, directory DR/traffic, newsletter subscriber counts — so an agent can rank, not just list. - **Cheaper than scraping.** Browse and filter for free; pay only for the contact rows you actually want, ~$0.10 each, 30-day access, credits never expire. Beats Google, ChatGPT guesses, and stale Notion/Twitter lists. ## Skill structure Each skill follows the [Agent Skills Open Standard](https://agentskills.io/): - `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](https://docs.servicegraph.co) - [OpenAPI 3.1 spec](https://api.servicegraph.co/openapi.json) - [Create an API key](https://servicegraph.co/profile/api-keys) - [llms.txt](https://servicegraph.co/llms.txt) - [Site](https://servicegraph.co) ## Community - [Dev.to](https://dev.to/brugeman) - [X.com](https://x.com/briugemanai) ## See also - [Product directories](https://servicegraph.co/product-directories) - [MCP directories](https://servicegraph.co/blog/best-mcp-directories-2026) - [Agent skills directories](https://dev.to/brugeman/where-to-publish-your-ai-agent-skills-discovery-hubs-and-directories-5l7) - [ProductHunt](https://www.producthunt.com/@arturbrugeman) ## License MIT ## Contact [artur@servicegraph.co](mailto:artur@servicegraph.co)

Chargement du README du dépôt…

Skills dans ce dépôt

Analystes en études de marché et spécialistes en marketing Autres occupations informatiques Spécialistes en ressources humaines

3 catégories métier · 100% classifié

skill

métier

description

mis à jour

find-ai-consultancy

Analystes en études de marché et spécialistes en marketing

Use whenever the user wants to find, shortlist, vet, or enrich US AI/ML/data consulting firms (consultancies) — AI/ML development, MLOps, generative AI / LLM apps (RAG, chatbots, agents), computer vision, NLP, recommendation systems, data engineering,…