paperclip-wiki-fetch

Paperclip Wiki の取得

paperclipai.plugin-llm-wiki プラグインブリッジ API を通じて Paperclip の wiki データを取得します。

読み取り専用の wiki 取得には、このスキルを使用してください。/api/wiki/... は使用しないでください。llm-wiki は、/api/plugins/paperclipai.plugin-llm-wiki/data/... 配下のプラグインブリッジルートを通じてデータを公開します。

入力

API を呼び出す前に、次の値を確認してください。

• Paperclip API のベース URL。例：https://your-paperclip-host.example.com
• TOKEN などの環境変数に格納されたベアラートークン
• companyId
• wikiId。通常は default
• spaceSlug。特定のスペースが指定されていなければ default。スペースを一覧表示するには api/spaces ルートを使用します
• ページの path。例：wiki/sources/rl-30-day-validation-plan.md

ユーザーが公開 URL のように見える wiki URL を指定した場合は、SPA ルートとして扱い、そこからページパスを抽出してください。例：

https://your-paperclip-host.example.com/<company-slug>/wiki/page/wiki/sources/rl-30-day-validation-plan.md

は次のように対応します。

wiki/sources/rl-30-day-validation-plan.md

path に会社のスラッグのプレフィックス、/wiki/page/、クエリ文字列、フラグメントを含めないでください。

パス形式

プラグインは 2 つのエンドポイントをマウントします。正しいプレフィックスを指定しないと、すべての呼び出しが 404 になります。

• 汎用データブリッジ（読み取り）：/api/plugins/paperclipai.plugin-llm-wiki/data/<key>。JSON ボディは { "params": { ... } }。
• スコープ付き REST ルート：/api/plugins/paperclipai.plugin-llm-wiki/api/<route>（/api セグメントがもう 1 つ必要）。フラットな JSON ボディまたはクエリ文字列を使用します。

MCP に関する注意点： MCP の paperclipApiRequest 経由で呼び出す場合は、先頭の /api を省略してください（MCP が付加します）。/api/plugins/... を渡すと /api/api/plugins/... になり、404 API route not found が返されます。直接 REST または curl を使用する場合は、ベアラートークンを指定し、完全な /api/plugins/... パスを使用してください。

ルート

データブリッジ経由で読み取ります（ボディは { "params": { ... } }）。

POST /api/plugins/paperclipai.plugin-llm-wiki/data/page-content   # page markdown body + title, pageType, updatedAt, hash
POST /api/plugins/paperclipai.plugin-llm-wiki/data/pages          # list wiki pages (optional includeRaw)
POST /api/plugins/paperclipai.plugin-llm-wiki/data/sources        # list captured raw sources (rawPath, title, status)

スコープ付き REST の読み取り（params ではなくクエリ文字列を使用）：

GET  /api/plugins/paperclipai.plugin-llm-wiki/api/spaces?companyId=<id>&wikiId=default      # list wiki spaces
GET  /api/plugins/paperclipai.plugin-llm-wiki/api/operations?companyId=<id>&spaceSlug=<s>   # list ingest/query/lint operations

読み取り用ルートはすべて board-or-agent です。

スペース

wiki はスペース（wiki ルート直下にある、スラッグをプレフィックスとするフォルダー）に分割されています。spaceSlug の既定値は default ですが、作成者別／チーム別のスペース（例：pathPrefix: spaces/<slug> を持つ creator-jane）もあります。api/spaces ルートで一覧表示してください。読み取りのたびに対象の spaceSlug を指定してください。省略すると default が対象になります。スペース内のパスは相対パス（wiki/sources/foo.md、raw/...）であり、spaces/<slug> は前に付けません。

リクエスト形式

トップレベルに params オブジェクトを含む JSON を送信します。

{
  "params": {
    "companyId": "<company-id>",
    "wikiId": "default",
    "spaceSlug": "default",
    "path": "wiki/sources/rl-30-day-validation-plan.md"
  }
}

data/pages と data/sources では、要求されたタスクに対して API がフィルタリングを明示的にサポートしていない限り、path を省略してください。

curl の例

ページの内容を取得する：

curl -s -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://your-paperclip-host.example.com/api/plugins/paperclipai.plugin-llm-wiki/data/page-content" \
  -d '{
    "params": {
      "companyId": "<company-id>",
      "wikiId": "default",
      "spaceSlug": "default",
      "path": "wiki/sources/rl-30-day-validation-plan.md"
    }
  }'

ページを一覧表示する：

curl -s -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://your-paperclip-host.example.com/api/plugins/paperclipai.plugin-llm-wiki/data/pages" \
  -d '{
    "params": {
      "companyId": "<company-id>",
      "wikiId": "default",
      "spaceSlug": "default"
    }
  }'

取得済みソースを一覧表示する：

curl -s -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://your-paperclip-host.example.com/api/plugins/paperclipai.plugin-llm-wiki/data/sources" \
  -d '{
    "params": {
      "companyId": "<company-id>",
      "wikiId": "default",
      "spaceSlug": "default"
    }
  }'

運用ルール

• ユーザーが wiki データを求めており、認証情報がすでに利用可能な場合は、自由に読み取ってください。
• ベアラートークンを表示したり、ファイルに書き込んだりしないでください。
• CLI が設定済みの場合は、API ベース URL と会社 ID の確認に paperclipai context show --json を優先してください。
• 不足している会社、wiki、スペース、ページパス、またはトークンの取得元がコンテキストから推測できない場合に限り、確認してください。
• wiki リクエストが一覧を返した場合は、ページを選ぶ前にタイトル、パス、更新日時、ハッシュを確認してください。
• ページの取得に失敗した場合は、ルートがプラグインブリッジルートであること、ページパスに SPA のプレフィックスが含まれていないこと、リクエストボディが params を使用していることを確認してください。
• 明示的な書き込みルートが追加され、オペレーターが変更ワークフローを承認しない限り、この API は読み取り専用として扱ってください。