From my-skills
Notion のページ内容・データベースレコードをローカルに取得するスキル。 ページをMarkdown形式で保存したり、データベースをCSV/JSONで取得したり、 キーワードでページを検索できる。複数ワークスペース(会社ごと)のアカウントを プロファイル名で切り替えられる。 ユーザーが「Notionのページを取得」「Notionのドキュメントを読み込んで」 「Notionのデータベースをダウンロード」「Notionを検索して」などと言ったとき、 またはNotionのURLが含まれているときは必ずこのスキルを使う。
How this skill is triggered — by the user, by Claude, or both
Slash command
/my-skills:notion-readerThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Notion のページ・データベース・検索結果をローカルに取得するスキル。
Notion のページ・データベース・検索結果をローカルに取得するスキル。
pip install requests がインストール済みであること~/.notion-profiles.json に Integration Token が登録済みであること初回または新しいワークスペースを追加する場合:
python3 <SKILL_DIR>/scripts/notion_reader.py setup
対話形式でプロファイル名(例: work-a、work-b)と Integration Token を登録する。
設定ファイルは ~/.notion-profiles.json に保存される:
{
"work-a": "secret_xxxxxxxxxx",
"work-b": "secret_yyyyyyyyyy"
}
Integration Token の取得方法:
python3 <SKILL_DIR>/scripts/notion_reader.py profiles
登録済みプロファイルの一覧を表示。
| ユーザーの意図 | コマンド |
|---|---|
| 「このNotionページを取得して」+ URL | page <URL> |
| 「このデータベースをCSVで取得して」+ URL | database <URL> --format csv |
| 「〇〇というページを検索して」 | search "〇〇" |
| 「〇〇社のアカウントで」「〇〇のプロファイルで」 | --profile <プロファイル名> |
| プロファイル未指定 | 登録済み一覧を表示して選択を促す(1つだけなら自動選択) |
ページ取得(Markdown保存)
python3 <SKILL_DIR>/scripts/notion_reader.py page <URL-or-ID> \
--profile <プロファイル名> \
[--output <保存先ディレクトリ>]
データベース取得
python3 <SKILL_DIR>/scripts/notion_reader.py database <URL-or-ID> \
--profile <プロファイル名> \
[--format csv|json] \
[--output <保存先ディレクトリ>]
キーワード検索
python3 <SKILL_DIR>/scripts/notion_reader.py search "キーワード" \
--profile <プロファイル名> \
[--limit 10]
プロファイル管理
python3 <SKILL_DIR>/scripts/notion_reader.py setup # 新規プロファイル追加
python3 <SKILL_DIR>/scripts/notion_reader.py profiles # 一覧表示
| エラー | 対処 |
|---|---|
| プロファイルが見つからない | setup コマンドで登録を促す |
| 401 Unauthorized | Integration Token が無効。再発行してプロファイルを更新 |
| 403 Forbidden | ページに Integration が接続されていない。Notion 側で「Connect to」設定が必要 |
| プロファイル未指定で複数登録あり | profiles コマンドで一覧を表示してユーザーに選択を求める |
npx claudepluginhub wataori/claude-skills --plugin my-skillsInteract with Notion workspaces via CLI using the unofficial private API. Supports CRUD on pages, databases, blocks, search, users, comments, and batch operations.
Automates Notion pages, databases, blocks, comments, users via Composio toolkit and Rube MCP. Use after connecting Notion OAuth and searching tools for schemas.
Migrates data to/from Notion databases or between workspaces with property mapping, validation, rate limiting. For CSV/JSON imports, exports, syncing, ETL pipelines.