mcpField
C
cortex-mine

cortex-mine

github.com/jezweb生产力1.1k54 次安装3 周前更新
代码仓库

关于 cortex-mine

cortex-mine 是从 Gmail 历史记录中提取联系人、客户、通信和关键信息的技能，并将结果保存为本地平面文件。它无需服务器，支持试运行、按日期采集和定期运行。

主要功能

  1. 01从 Gmail 历史记录提取结构化信息
  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_SIZE50每次运行处理的线程数
CORTEX_OWNER_EMAIL—你的电子邮件 — 从联系人中排除

参考资料

  • 文件架构：{skill_path}/references/file-schema.md
  • 预筛选规则：{skill_path}/references/prefilter-patterns.md
  • 导出模式：{skill_path}/references/export-adapters.md

评论

支持 Markdown