API
Search the catalog from your own code or agent: the same search, filters and safety ratings as this site. No sign-in or key is needed. Safety ratings come from an automated static scan, not a guarantee; see how ratings work.
GET /api/search
Returns up to 20 listings for a plain-language query, best match first. Limit: 60 requests a minute per IP address; past it the answer is 429 with a Retry-After header.
GET https://findsafeskills.com/api/search?q=fill+pdf+forms&safety_rating=not_red&types=skill&source=agent
| Parameter | Value | Meaning |
|---|---|---|
q | text, required | What to search for, in plain language. |
source | agent, skill, mcp or web | Who is asking; defaults to web. Send agent from your own software: only web searches can set the site's visitor cookie. |
agent | text | Only listings that say they work with this coding agent; listings that name no agent are left out. |
category | text | Only this category: one of the names the search page's Category filter lists, such as Security & safety, Data & databases or Other. |
tags | comma-separated list | Only listings tagged with at least one of these. |
safety_rating | text | Safety rating filter: 'green' (no issues found), 'yellow' (review suggested), 'red' (flagged), or 'not_red' (everything except flagged, including not-yet-scanned). Static text analysis only — not a guarantee. |
sort | text | Result order. Defaults to best match. |
types | comma-separated list | Only these kinds of listing: 'skill', 'marketplace', 'mcp'. |
min_stars | whole number | Only repos with at least this many GitHub stars. |
updated_within_days | whole number | Only repos pushed to within this many days. |
has_license | 1 or true | Only repos with a license GitHub recognized. |
official | 1 or true | Only official publishers (Anthropic, OpenAI, Google). |
author_verified | 1 or true | Only listings whose repository's author has verified ownership. |
offset | whole number | Skip this many results (for paging). |
sort takes one of: relevance, alpha_asc, alpha_desc, stars_asc, stars_desc, likes_asc, likes_desc, dislikes_asc, dislikes_desc, recent_added, recent_updated. Page through results with offset in steps of 20.
The answer holds results, one object per listing with its details, safety rating and findings; degraded, true when the query could not be understood by meaning and results are plain keyword matches; and searchId, used by this site to connect clicks to the search. Abridged:
{
"results": [
{
"slug": "owner--pdf-tools",
"display_name": "pdf-tools",
"description": "Fill, split and merge PDF forms.",
"platform": "claude-code-skill",
"repo_url": "https://github.com/owner/pdf-tools",
"github_stars": 412,
"safety_rating": "green",
"safety_findings": [],
"safety_scan_source": "manifest+readme",
"similarity": 0.71,
...
}
],
"degraded": false,
"searchId": "…"
}A result whose scan may not cover what would be installed also has deeper_check: reasons, one or more of unrated (no safety rating yet), changed (pushed after its scan) and partial (its scripts only partly scanned), and command, the scanskillsafety --deep command that checks it on your own machine.
A listing's page is https://findsafeskills.com/listings/{slug}.
POST /api/mcp
An MCP server (Streamable HTTP, answering each request in one response) with one tool, search_skills. It takes query and the same filters as /api/search above, as JSON values, and returns the same results. Limit: 60 requests a minute per IP address. To connect Claude Code, Cursor, Codex or another client, see Connect your agent.
POST /api/mcp
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_skills",
"arguments": { "query": "fill pdf forms", "safety_rating": "not_red", "types": ["skill"] }
}
}GET /api/changelog.json
The 200 most recent changes findsafeskills noticed in listings (a new version, or changed manifest content), newest first. Each entry has slug, displayName, previousVersion, newVersion, summary and detectedAt; the feed has generatedAt.
GET /api/listings/{slug}/badge.svg
A badge showing a listing's safety rating, for a README; every listing page offers it ready to copy under “Badge for your README”. It is kept for 60 minutes, so a new rating can take that long to show. An unknown slug gets a grey “Not listed” badge with status 404.
GET /api/listings/lookup
The listings at a repository, given its address in repo; a link to a folder, file or branch inside the repository is reduced to the repository itself. This is what scanskillsafety --deep compares its own check with. Limit: 60 requests a minute per IP address; a repo that is not a repository address is answered with 400.
GET https://findsafeskills.com/api/listings/lookup?repo=https://github.com/owner/pdf-tools
The answer holds listings, empty when nothing is listed there. Each has slug, url (its page), rating, scannedAt (when it was last scanned), scanCommit and scriptsCommit (the commits its text and its scripts were scanned at, when known), pushedAt (the repository's last push) and scriptsScan (full, or partial when only some of its scripts were scanned).
Using the API
The Terms cover the API and the MCP server. In short: stay within the rate limits, don't copy listings, ratings or findings in bulk to republish them elsewhere (showing the results of your own users' searches is fine), and credit findsafeskills as below.
Beside each listing or safety rating you show, put the words “Safety rating from findsafeskills”, linked to that listing's page. For the listing owner--pdf-tools:
[Safety rating from findsafeskills](https://findsafeskills.com/listings/owner--pdf-tools)
<a href="https://findsafeskills.com/listings/owner--pdf-tools">Safety rating from findsafeskills</a>