cosense

Cosense (Scrapbox)

Cosense ページの取得・検索・作成・編集・削除・書き換え。CLI 経由で実行。

コマンド

npx -y scrapbox-cosense-mcp で実行する（グローバルインストール済みなら scrapbox-cosense-mcp 直接でもよい）。

• npx -y scrapbox-cosense-mcp get <title> — ページ取得
• npx -y scrapbox-cosense-mcp search <query> — キーワード検索
• npx -y scrapbox-cosense-mcp list [--sort=X --limit=N] — ページ一覧
• npx -y scrapbox-cosense-mcp create <title> [--body=TEXT] — ページ作成（markdown自動変換）
• npx -y scrapbox-cosense-mcp insert <title> --after=TEXT --text=TEXT — 行挿入
• npx -y scrapbox-cosense-mcp edit <title> --target=TEXT --text=TEXT [--all] — 行置換（完全一致、複数行ブロック対応、既定は最初の1件のみ）
• npx -y scrapbox-cosense-mcp delete-lines <title> --target=TEXT [--all] — 行削除（完全一致、複数行ブロック対応）
• npx -y scrapbox-cosense-mcp delete <title> [--dry-run] — ページ削除（COSENSE_ENABLE_DELETE=true が必要。取り消せないので、まず --dry-run で確認する）
• npx -y scrapbox-cosense-mcp rewrite <title> --body=TEXT [--dry-run] — ページ全体の書き換え（COSENSE_ENABLE_DELETE=true が必要。取り消せないので、まず --dry-run で確認する）
• npx -y scrapbox-cosense-mcp url <title> — URL生成
• npx -y scrapbox-cosense-mcp context <title> [--hop=1|2] — 関連ページ一括取得（Smart Context）

詳細は npx -y scrapbox-cosense-mcp <command> --help で確認。

全コマンド共通: --compact でトークン効率の高い出力、--project=NAME でプロジェクト指定、--json でJSON出力。

環境変数の設定

必要な環境変数

変数名	説明	必須
COSENSE_PROJECT_NAME	対象プロジェクト名（--project で上書き可）	はい
COSENSE_SID	セッションID（プライベートプロジェクト、create/insert/edit/delete-lines/delete/rewrite/context 操作に必要）	条件付き
COSENSE_ENABLE_DELETE	true のときだけ delete / rewrite サブコマンドが使える	いいえ

永続化方法

.claude/settings.local.json（gitignore対象）の env キーに追加してください。

{
  "env": {
    "COSENSE_PROJECT_NAME": "your-project-name",
    "COSENSE_SID": "s:your-session-id"
  }
}

全プロジェクト共通で使う場合は ~/.claude/settings.json に設定することもできます。

SID の取得方法

1. ブラウザで Cosense にログイン
2. 開発者ツール → Application → Cookies
3. connect.sid の値をコピー