- name
- weread-to-flomo
- description
- Sync WeRead (微信读书) highlights and notes into flomo with incremental deduplication and configurable sync scope. Use when the user wants to export or sync WeRead annotations to flomo, including (1) only today's new highlights, (2) a specified date, or (3) a full migration of all exported notes. Supports configurable tag templates, local state tracking, and Markdown-based intermediate storage.
weread-to-flomo
Use this skill to move WeRead highlights/notes into flomo safely.
Default workflow
- Export WeRead notes into local Markdown files first.
- Set
FLOMO_WEBHOOKandWEREAD_COOKIEvia environment variables or config files outside the skill package. - Choose one sync scope:
- today: only today's new entries - date: entries from a specified day - all: full migration
- Use local state tracking to avoid duplicate pushes.
- Run
--dry-runbefore the first real sync or before a bulk migration. - Prefer
todayordatemode when the user already has historical reading notes in flomo.
Modes
1. Sync today's new entries
python3 ./scripts/weread_to_flomo.py --weread-dir /path/to/weread --mode today --flomo-webhook "$FLOMO_WEBHOOK" --dry-run
python3 ./scripts/weread_to_flomo.py --weread-dir /path/to/weread --mode today --flomo-webhook "$FLOMO_WEBHOOK"2. Sync a specified date
python3 ./scripts/weread_to_flomo.py --weread-dir /path/to/weread --mode date --date 2026-03-26 --flomo-webhook "$FLOMO_WEBHOOK"3. Full migration
python3 ./scripts/weread_to_flomo.py --weread-dir /path/to/weread --mode all --flomo-webhook "$FLOMO_WEBHOOK"Sync scopes
today: sync only entries whose WeRead timestamp falls on the current Asia/Shanghai day.date: sync only entries from--date YYYY-MM-DD.all: migrate all exported entries.
Tag template
Default output:
内容正文
#02_读书 #02_读书/「书名」Override with:
--tag-prefix "02_读书"State and dedup
- State file defaults to
.weread-flomo-state.jsonunder the WeRead export directory. - Dedup uses
bookmark:<id>/review:<id>. - Re-running the same scope only sends unsent entries.
Notes
- Keep webhook/cookie outside the skill directory.
- Dry-run on first use.
- If the user already manually copied many old notes into flomo, prefer
todayordatemode beforeall.
References
- Read
references/formatting.mdwhen adjusting output structure or tag conventions. - Read
references/publishing.mdwhen preparing the skill for ClawHub publication.