mcpField
C
cortex-mine

cortex-mine

github.com/jezweb生産性1.1k54 回インストール3 週間前に更新
リポジトリ

cortex-mine について

cortex-mine は、Gmail の履歴から連絡先、顧客、通信、重要事項を抽出し、ローカルのフラットファイルに保存するスキルです。サーバーは不要で、ドライラン、日付指定、定期実行に対応します。

主な機能

  1. 01Gmail 履歴から構造化データを抽出
  2. 02ローカルのフラットファイルに保存
  3. 03ドライランと開始日の指定
  4. 04バッチごとのスレッド数の設定
  5. 05定期実行の方法を提供

活用シーン

  1. 01メールから連絡先や顧客情報を整理
  2. 02ファイル書き込み前の抽出テスト
  3. 03指定日以降のメールを処理
  4. 04毎日の抽出をスケジュール

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jezweb/claude-skills --skill cortex-mine

インストール後、Claude Code で/cortex-mineを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
export-adapters.md
file-schema.md
prefilter-patterns.md
scripts/
cortex-mine.py

詳細

Knowledge Cortex — Mine

Gmailの履歴をマイニングして、連絡先、クライアント、やり取り、重要な事実を構造化されたフラットファイルにまとめ、~/.cortex/ に保存します。サーバーは不要です。ファイルは自分で管理できます。

呼び出されたとき

ファイル操作を行う前に、保存形式について {skill_path}/references/file-schema.md を読んでください。

コマンド

ユーザーの発言アクション
「run the cortex」／「cortex run」マイニングを実行
「cortex dry run」書き込みを行わずにマイニング — --dry-run を渡す
「cortex from DATE」指定した日付以降をマイニング — --from YYYY-MM-DD を渡す
「set up the cortex」初回セットアップを実行

セットアップ（初回実行）

前提条件を確認します：

which gws || echo "MISSING: npm install -g @googleworkspace/cli"
python3 -c "import anthropic" 2>/dev/null || echo "MISSING: pip install anthropic"
ls ~/.cortex/state.json 2>/dev/null || echo "FIRST RUN"

gws が見つからない場合：ユーザーに npm install -g @googleworkspace/cli、続けて gws auth setup を実行するよう伝えてください。 anthropic が見つからない場合：ユーザーに pip install anthropic を実行するよう伝えてください（管理対象のPythonでは pip install anthropic --break-system-packages）。 初回実行の場合：ストレージを初期化します。

mkdir -p ~/.cortex/originals
echo '{}' > ~/.cortex/contacts.json
echo '{}' > ~/.cortex/clients.json
touch ~/.cortex/communications.jsonl ~/.cortex/knowledge.jsonl ~/.cortex/files.jsonl

~/.cortex/state.json に書き込みます：

{"version":"1.0","cursors":{"gmail":null},"last_run":null,"totals":{"contacts":0,"clients":0,"communications":0,"knowledge":0,"files":0},"runs":[]}

マイニング

python3 {skill_path}/scripts/cortex-mine.py
python3 {skill_path}/scripts/cortex-mine.py --dry-run
python3 {skill_path}/scripts/cortex-mine.py --from 2024-01-01
python3 {skill_path}/scripts/cortex-mine.py --batch-size 25

スクリプトは完了時に実行レポートを出力します。そのままユーザーに表示してください。

よくあるエラー：

  • gws: command not found — gws CLIをインストールしてください
  • AuthError／403 — gws auth setup を実行してください
  • ANTHROPIC_API_KEY not set — 環境変数を設定するか、~/.cortex/.env に追加してください
  • ModuleNotFoundError: anthropic — pip install anthropic

スケジュール設定

  • Claude Code Desktop：Cowork > Scheduled > New Task > Run the cortex-mine skill > Daily
  • CLI：/loop 24h run the cortex-mine skill
  • Cron：0 6 * * * cd ~ && ANTHROPIC_API_KEY=sk-... python3 /path/to/cortex-mine.py

データのエクスポート

cortexのデータをObsidian、SQLite、Notion、CRMシステム、またはカスタムAPIにエクスポートする方法については、{skill_path}/references/export-adapters.md を参照してください。

環境変数

変数デフォルト用途
CORTEX_DIR~/.cortexストレージのルート
ANTHROPIC_API_KEY—抽出に必要
CORTEX_BATCH_SIZE501回の実行あたりのスレッド数
CORTEX_OWNER_EMAIL—自分のメールアドレス — 連絡先から除外

参考資料

  • ファイルスキーマ：{skill_path}/references/file-schema.md
  • 事前フィルタールール：{skill_path}/references/prefilter-patterns.md
  • エクスポート方法：{skill_path}/references/export-adapters.md

コメント

Markdown 対応