notcrawl について
notcrawl は、ローカルの Notion アーカイブを調べるコマンドラインスキルです。ページ検索やデータベース分析に使え、デスクトップキャッシュまたは認証情報とページアクセス権がある場合は API から同期し、読み取り専用 SQL と Markdown エクスポートにも対応します。
主な機能
- 01デスクトップキャッシュまたは Notion API から同期
- 02アーカイブページの検索
- 03データベース一覧の表示
- 04読み取り専用 SQL クエリ
- 05Markdown ファイルのエクスポート
活用シーン
- 01ローカル Notion ページの内容確認
- 02ページやデータベースの件数確認
- 03アーカイブの更新状況確認
- 04Markdown エクスポートの更新
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ steipete/ agent-scripts --skill notcrawlインストール後、Claude Code で/notcrawlを入力して読み込まれたか確認します。
詳細
notcrawl
ローカルの Notion アーカイブに関する質問には、こちらを使用します。デスクトップアプリはローカルキャッシュを読み込みます。API 同期には NOTION_TOKEN とページへのアクセス権が必要です。
ソース
- DB:
~/.notcrawl/notcrawl.db - ページ:
~/.notcrawl/pages - CLI:
notcrawl
更新
notcrawl doctor
notcrawl status
notcrawl sync --source desktop
必要な場合に限り、認証情報とページへのアクセス権が利用できるときは API を使用します。
notcrawl sync --source api
クエリのワークフロー
- 最近または現在の Notion に関する質問では、最新の状態を確認します。
- まずページを検索し、正確な件数やスキーマレベルの分析には読み取り専用 SQL を使用します。
- ユーザーが Markdown ファイルの更新を必要としている場合は、
export-mdを使用します。 - 日付の範囲、ページ/データベースの ID、件数、ソースの制限を報告します。
構文については、ルートまたはサブコマンドのヘルプを参照してください:notcrawl --help、
notcrawl search --help、notcrawl sql --help。
よく使うコマンド:
notcrawl search --limit 20 "query"
notcrawl databases
notcrawl sql "select count(*) from pages;"
notcrawl export-md
コメント
Markdown 対応