Use whenever the user wants to find, rank, or shortlist directories and listing sites where they can submit an AI product — an AI tool, AI app, AI agent, or agent skill / plugin — to get backlinks, referral traffic, and discovery. Triggers on "where can I list my AI tool", "directories to submit my AI agent", "agent-skills directories", "best AI tool directories for backlinks", "where do I get my GPT/Claude app discovered", or "pull submission details for these AI-directory domains", even when described indirectly. Drives the ServiceGraph API (api.servicegraph.co) — a catalog of 1,000+ product directories enriched with Domain Rating, backlinks, and organic traffic. Defer to find-mcp-directories for MCP-server listings specifically, and to find-product-directories for general SaaS/software/app launches with no AI angle. Skip finding an AI consultancy/agency to hire (use find-ai-consultancy), comparing AI products ("ChatGPT vs Claude"), building an AI tool (do-the-work), and AI link-building *services*.
Instrucciones de origen · Vista previa de solo lectura
name
find-ai-directories
description
Use whenever the user wants to find, rank, or shortlist directories and listing sites where they can submit an AI product — an AI tool, AI app, AI agent, or agent skill / plugin — to get backlinks, referral traffic, and discovery. Triggers on "where can I list my AI tool", "directories to submit my AI agent", "agent-skills directories", "best AI tool directories for backlinks", "where do I get my GPT/Claude app discovered", or "pull submission details for these AI-directory domains", even when described indirectly. Drives the ServiceGraph API (api.servicegraph.co) — a catalog of 1,000+ product directories enriched with Domain Rating, backlinks, and organic traffic. Defer to find-mcp-directories for MCP-server listings specifically, and to find-product-directories for general SaaS/software/app launches with no AI angle. Skip finding an AI consultancy/agency to hire (use find-ai-consultancy), comparing AI products ("ChatGPT vs Claude"), building an AI tool (do-the-work), and AI link-building *services*.
Drive the ServiceGraph API (https://api.servicegraph.co) to find and
rank directories where a founder can submit an AI product — AI tools, AI
apps, AI agents, and agent skills / plugins — via the product_directory
dataset. The catalog has 1,000+ directories, each enriched with Domain
Rating (dr), backlink counts, and organic traffic. The AI slice is
large and fast-moving: ~370 dirs match "AI tools", ~28 match "AI agents", and
a growing set are dedicated agent-skill / plugin registries (e.g.
clawhub.ai, smithery.ai).
This is a "where to launch / where to get backlinks" skill, not a "who to
hire" skill. Each row is a directory you submit to, not a firm and not a
product. The payoff is a backlink from a high-authority domain (SEO) plus
discovery traffic from people browsing for AI tools.
Any HTTP client works (curl, fetch, requests). Examples below use curl.
Sibling skills — defer when the niche is narrower or broader
MCP servers specifically ("where do I list my MCP server", "MCP
directories") → find-mcp-directories. (MCP registries that also list
agent skills/tools overlap both — if the ask is broadly "AI agent tooling,"
this skill is fine.)
General SaaS / software / app launch with no AI angle ("Product Hunt
alternatives for our SaaS") → find-product-directories.
This skill owns the AI-tool / AI-agent / agent-skill niche.
Prerequisites
ServiceGraph access, either:
the ServiceGraph MCP server (https://mcp.servicegraph.co) loaded in
your harness — this plugin's .mcp.json wires it up; OAuth 2.1 + PKCE
keeps credentials in the harness sandbox — or
a ServiceGraph API key (vk_…, minted at
https://servicegraph.co/profile/api-keys) available as
SERVICEGRAPH_API_KEY in the environment or .env.local for the REST
path (setup steps under Auth below).
An HTTP client for the REST path — the examples use curl.
Instructions
The loop is free-first: discovery, validation, search, and brief reads cost
nothing; only unlock after the user confirms the spend.
Pick the call path — the ServiceGraph MCP tools if loaded, otherwise the
REST flow (MCP server and Auth sections below).
GET /v1/datasets/product_directory/fields?include_values=1 — confirm the
fields and values you plan to filter on exist.
Build the filter (Filter DSL below) and validate it with
GET /v1/datasets/product_directory/check — or draft it from plain English via
POST /v1/datasets/product_directory/translate-intent.
GET /v1/datasets/product_directory/search — present the free brief cards and
let the user pick.
Quote the unlock cost (10 credits per row, 30-day TTL) and get an explicit
go-ahead.
POST /v1/datasets/product_directory/unlocks with the chosen apexes; report the
revealed detail.
GET /v1/me/credits to report the remaining balance when asked.
MCP server (preferred for authed calls)
If your harness has the ServiceGraph MCP server loaded (tool names contain
servicegraph), prefer those tools — credentials stay in the harness sandbox
via OAuth 2.1 + PKCE, no token in LLM context. Otherwise use the REST flow.
API surface (dataset id: product_directory)
Every endpoint requires the bearer (Authorization: Bearer vk_…).
Endpoint
Cost
Use it for
GET /v1/datasets/product_directory/fields[?include_values=1&q=]
free
Filter-field catalog + DSL grammar. Call first per session.
GET /v1/datasets/product_directory/values/:field[?q=&limit=]
free
Enumerate values for one field.
GET /v1/datasets/product_directory/check?filter=…
free
Validate a filter.
POST /v1/datasets/product_directory/translate-intent
free
{intent} → DSL filter + sanity count.
GET /v1/datasets/product_directory/search?filter=…&limit=&offset=
free
Brief cards (incl. dr) + per-row unlock hint + total.
Cost model. Discovery / search / brief reads are free — including the dr
ranking signal. Unlocking a row costs 10 credits, lasts 30 days, and
reveals the gated fields: editor_note (how to submit + whether the
listing gives a backlink), organic_traffic, and total_visits.
Auth
Tokens are vk_* API keys. Keep the token out of the LLM context — never
read .env* into context; route authed calls through a shell wrapper.
Try the call through a wrapper that sources .env.local:
On 401, prompt the user (don't accept the key in chat):
"Open https://servicegraph.co/profile/api-keys, sign in, create a key,
and add SERVICEGRAPH_API_KEY=vk_… to .env.local (or export it). Tell me
when done — please don't paste the key into chat."
Retry after the user signals ready.
Filter DSL
GitHub-search-style. AND binds tighter than OR; comma list = OR within one
predicate; negation is -x / NOT x; any bareword is a keyword search
across the directory's name, title, description, listed metadata, and the
niche tag (so "ai agents" matches dirs whose niche is "AI agent tools").
Multiple barewords AND; wrap multi-word phrases in double quotes.
"ai tools" dr>=50
("ai agents" OR "ai agent") dr>=40
skills agent # → keyword:skills AND keyword:agent (agent-skill registries)
industry:software_saas ai
Fields that matter here
Field
Free in brief?
Use it for
dr
yes
Domain Rating 0–100 — the primary authority filter. Briefs come sorted by dr descending, so rank for free.
Real reach. Filterable while hidden (organic_traffic>=10000); value shows after unlock.
editor_note
gated
Submission instructions + backlink yes/no.
industry
yes
Coarse vertical refiner (software_saas, etc.); keyword on niche is usually sharper for AI sub-niches.
has
yes
Presence flags (has:pricing, has:g2, …).
Because dr is free and briefs are pre-sorted by it, rank a shortlist by
authority for zero credits — unlock only to reveal submission notes + traffic.
Identifying rows — apex
Keyed by apex domain (aiagentsdirectory.com, not a full URL). Strip
user-supplied URLs to the apex before :apex or unlock calls.
Output
All responses are JSON.
Search returns free brief directory cards — apex, name, and the
dr (Domain Rating) signal, pre-sorted by dr descending — plus a per-row
unlock hint and the match total.
Unlock (POST …/unlocks) reveals each directory's gated fields —
editor_note (how to submit and whether the listing gives a backlink),
organic_traffic, and total_visits — with per-item billing and a 30-day
TTL (was_cached:true rows are free).
Errors arrive as a JSON envelope
{"error": {"code": "…", "message": "…"}} — see Errors below.
Examples
A. AI-tool directories (the broad case)
User: "Where can I list our new AI tool to get backlinks and traffic?"
GET /v1/datasets/product_directory/search?filter="ai tools"+dr>=50&limit=20
# → aichief.com, aiagentstore.ai, … sorted by dr desc. Present top N (free).
Broaden with the bare ai keyword if the pool is thin; tighten with dr>=60.
B. AI-agent directories
User: "Directories specifically for AI agents, not just AI tools."
GET /v1/datasets/product_directory/search?filter=("ai agents" OR "ai agent")&limit=20
# → aiagentsdirectory.com, agenthunter.io, aiagentstore.ai, smithery.ai, …
C. Agent-skill / plugin registries
User: "Where do I publish our Claude/agent skill so people find it?"
These are emerging registries for agent skills and plugins (distinct from
generic AI-tool lists). Lead with the skills/agent keywords:
GET /v1/datasets/product_directory/search?filter=skills+agent&limit=15
# → skills.sh, smithery.ai, aiagentsdirectory.com, agentskills.so, … sorted by dr desc
Present the top hits by dr (free), then unlock the user's picks to get each
one's submission note + traffic numbers before publishing.
Many agent-skill registries overlap with MCP registries (Smithery lists
both). If the user's artifact is specifically an MCP server, route to
find-mcp-directories for the tuned recipes.
D. High-reach only (gate on traffic)
User: "Only directories that actually drive traffic."
GET /v1/datasets/product_directory/search?filter="ai tools"+organic_traffic>=20000&limit=15
# organic_traffic is gated but filterable — unlock picks to see the numbers.
E. Intent translator
POST /v1/datasets/product_directory/translate-intent
{ "intent": "directories to list an AI agent for backlinks and discovery" }
# → {filter, normalized, count}. Sanity-check count, then search.
F. Unlock submission instructions
# Present briefs ranked by dr (free). "Unlocking 6 = 60 credits, 30-day TTL —
# reveals each one's submission note (how + backlink yes/no) and traffic."
POST /v1/datasets/product_directory/unlocks
{ "apexes": ["clawhub.ai", "aiagentsdirectory.com", "aichief.com", "..."] }
Surface each editor_note verbatim — it tells the user the submission effort
and whether they actually get a backlink.
G. BYO apex list — score AI directories I already have
GET /v1/datasets/product_directory/:apex per domain — free brief with dr
(404 = not in catalog, no charge). Flag misses, rank hits by dr.
User picks N. POST /unlocks (10×N credits, atomic) reveals notes + traffic.
Within 30-day TTL, repeat unlocks are free.
Gotchas
Rows are directories, not firms or products. Hiring an AI consultancy →
find-ai-consultancy. Comparing AI products ("ChatGPT vs Claude") is not
what this dataset answers.
dr is free and briefs are pre-sorted by it — rank for zero credits.
Gated fields are still filterable (organic_traffic>=10000).
Catalog is global, not US-only. Don't refuse non-US asks.
AI ↔ MCP ↔ agent-skill registries overlap. When the artifact is
specifically an MCP server, defer to find-mcp-directories.
Multi-word phrases must be quoted.ai agents = two AND'd keywords;
"ai agents" is one phrase.
Unlock is atomic (402 charges nothing) and within-TTL re-views are free.
position included; fix and re-validate with /check.
400
field_not_in_dataset
Drop the field.
400
invalid_apex
Re-normalize to apex.
401
unauthorized
Re-prompt for a fresh vk_….
402
insufficient_credits
needed/balance in payload; nothing charged.
404
not_found / not_in_dataset
Apex not in dataset. Skip; not charged.
429
rate_limited
Honor Retry-After.
End-to-end example
User: "We just shipped an AI agent and an accompanying agent skill. Find the
highest-authority directories to submit both to, and tell me how to submit to
the top few."
# 1. Discover (once per session)
GET /v1/datasets/product_directory/fields?include_values=1
# 2. Two scoped searches (free), both pre-sorted by dr desc
GET /v1/datasets/product_directory/search?filter=("ai agents" OR "ai agent")+dr>=40&limit=15
GET /v1/datasets/product_directory/search?filter=skills+agent&limit=15 # agent-skill registries
# 3. Present merged shortlist ranked by dr. User picks 5.
# "Unlocking 5 = 50 credits, 30-day TTL — reveals submission notes + traffic."
# 4. Atomic unlock (charges 50 credits)
POST /v1/datasets/product_directory/unlocks
{ "apexes": ["smithery.ai", "skills.sh", "aiagentsdirectory.com", "agenthunter.io", "aichief.com"] }
# 5. Surface each editor_note verbatim + traffic so the user can prioritize.
