本文へ移動
cccskills

API・MCP（開発者向け）

cccskills に載っている Agent Skills を、プログラムや AI エージェントから検索できます。日本語・英語のどちらの語でも当たり、概要は日本語・英語・中国語・韓国語で返します。 返すのはメタデータ（名前・概要・作者・スター数・カテゴリ・ライセンス・URL）だけで、SKILL.md の本文や有料スキルの中身は含みません。

ダッシュボードの「API・MCP」で、無料の API キーを作れます。キーなしでも少しだけ試せます。

MCP サーバー

エンドポイントは https://cccskills.com/mcp（Streamable HTTP）です。ツールは search_skills（検索）・get_skill（詳細）・list_categories（カテゴリ）・get_usage（残り回数）の 4 つで、検索回数を使うのは search_skills だけです。

Claude Code

claude mcp add --transport http cccskills https://cccskills.com/mcp \
  --header "Authorization: Bearer <API キー>"

Cursor・Claude Desktop など（JSON の設定）

{
  "mcpServers": {
    "cccskills": {
      "url": "https://cccskills.com/mcp",
      "headers": { "Authorization": "Bearer <API キー>" }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.cccskills]
url = "https://cccskills.com/mcp"
bearer_token_env_var = "CCCSKILLS_API_KEY"

キーを付けなければ、IP ごとに 1 時間 20 回までのお試しになります。キーを付けると、REST API と同じアカウントの検索回数を使います。

REST API

キーは Authorization: Bearer ccs_live_... で渡します。成功すると { "success": true, "data": ... }、失敗すると { "success": false, "error": { "code", "message" } } を返します。 仕様は OpenAPI（/openapi.json） にまとめています。

curl -H "Authorization: Bearer <API キー>" \
  "https://cccskills.com/api/v1/skills/search?q=議事録&limit=5&lang=ja"
エンドポイント内容検索回数
GET /api/v1/skills/searchキーワード検索。q（必須）・page・limit（〜50）・sortBy（relevance / stars / recent / rating / downloads）・category・price（free / paid）・source（github / native）・official・lang1 回
GET /api/v1/skills/{slug}スキル 1 件のメタデータと使いどころ使わない
GET /api/v1/categoriesカテゴリの一覧と件数使わない
GET /api/v1/usage今のプランと残り回数使わない
GET /api/v1/export条件に合うスキルを CSV / JSON でまとめて出力（format・rows ほか検索と同じ条件。q は省略可）エクスポートの上限を使う

スキルのメタデータ

  • description / descriptionLang：lang で指定した言語の概要と、その実際の言語。まだ訳が無いときは英語か原文になります。
  • contentLang：SKILL.md の本文が書かれている言語（訳ではなく原文の言語）。
  • isFork：GitHub でフォークされたリポジトリのスキル。
  • isCopy / copyOf：同じ名前で説明文が同じか似ているスキルが複数あるとき（dotfiles への丸写しなど）、代表以外は isCopy: true になり、copyOf に代表（公式 → スター数が多い順）を入れます。代表は元の作者とは限りません。

残り回数はレスポンスヘッダー X-RateLimit-Daily-Remaining（有料プランは X-RateLimit-Monthly-Remaining）と X-RateLimit-Reset で分かります。

料金と上限

プラン料金（税込）検索（REST・MCP 共通）エクスポート
キーなし—REST: IP ごとに 1 日 50 回・1 分 10 回
MCP: IP ごとに 1 時間 20 回		使えません
Free無料1 日 50 回（UTC）1 日 1 回・1 回 500 行まで
Standard¥15,000 / 年月 5,000 回・1 日の上限なし月 20,000 行・1 回 10,000 行まで
Pro¥45,000 / 年月 25,000 回・1 日の上限なし月 100,000 行・1 回 10,000 行まで
  • 数えるのは成功したキーワード検索だけです。詳細・カテゴリ・残り回数の取得や、こちらの不具合で失敗した検索は数えません。
  • API キー 1 本あたり 1 分 30 回までです。同じアカウントのキーは検索回数を共有します。
  • 有料プランは年額のお支払いで、上限は契約日から 1 か月ごとに戻ります（使い残しは繰り越しません）。
  • Standard から Pro へはいつでも変更でき、差額を日割りで請求します。解約は期間の終わりに反映され、日割りの返金はありません。

API キーを作る・プランを申し込む

エラー

codeHTTP意味
INVALID_API_KEY401キーが正しくないか、無効にされています
MISSING_QUERY400q（MCP では query）がありません
INVALID_QUERY400検索語が長すぎるか、文字・数字を含みません
INVALID_PAGE / INVALID_LIMIT400page は 1〜500、limit は 1〜50（MCP は 1〜20）
INVALID_LANGUAGE400lang は ja / en / zh / ko
SKILL_NOT_FOUND404その slug のスキルがありません
LOGIN_REQUIRED401エクスポートにはキーかログインが必要です
DAILY_QUOTA_EXCEEDED4291 日の検索回数を使い切りました（UTC 0 時に戻ります）
HOURLY_QUOTA_EXCEEDED429キーなしの MCP のお試し分（1 時間）を使い切りました
MONTHLY_QUOTA_EXCEEDED429契約月の検索回数・エクスポート行数を使い切りました
RATE_LIMITED4291 分あたりの回数を超えました。Retry-After 秒待ってください
SEARCH_INDEX_UNAVAILABLE503検索が一時的に使えません。回数には数えません
RATE_LIMIT_UNAVAILABLE503回数の確認が一時的にできません

429 と 503 には、待つ秒数を Retry-After ヘッダーで付けます。

ご利用にあたって

  • GitHub の公開スキルの中身は各リポジトリのライセンスに従います。API で返すのは cccskills が作った概要と、公開されている情報だけです。
  • 取得したデータを使ったサービスを公開するときは、各スキルの url（cccskills のページ）か githubUrl へのリンクを付けてください。
  • 上限を避けるためにキーやアカウントを分けて使うことはお控えください。