Flomo 笔记归档工具#

功能#

1. 完整获取 - 获取 Flomo 指定月份的所有笔记，处理 API 50条/次的限制
2. 质量评估 - 自动评估笔记质量，标记低质量/碎片化记录

核心策略#

Flomo 的 memo_search API 单次最多返回 50 条笔记。本工具采用智能分层策略：

1. 按周获取 - 默认粒度，大部分情况足够
2. 降级按天 - 当某周返回 50 条时，降级为按天获取该周
3. ID 去重 - 处理周边界重叠，确保笔记不重复

使用方法#

获取某月笔记（带质量评估）#

bash

python3 scripts/fetch_month.py <年> <月>

示例：

bash

python3 scripts/fetch_month.py 2025 7

仅评估已有数据#

bash

python3 scripts/evaluate_quality.py /tmp/flomo_YYYY_MM.json

质量评估规则#

规则结果说明有标签 + 字数≥50高质量已分类且内容充实含链接/图片高质量有多媒体内容字数<20低质量字数过少无标签 + 字数<100低质量建议人工审阅疑似流水账关键词低质量如"起床了""晚安"等

输出格式#

• 默认：统计摘要 + 质量报告 + 保存到 /tmp/flomo_YYYY_MM.json
• JSON 模式： --json 输出完整 JSON
• 详细模式： -v 显示每日获取进度

技术细节#

• API 限制：单次最多 50 条
• 调用频率：每次调用间隔 100ms
• 数据已包含：content, tags, word_count, created_at 等完整字段
• 无需额外 batch_get 调用

注意事项#

• 需要 mcporter 已配置 flomo MCP 服务器
• 结果文件保存在 /tmp/ 目录，需及时转存