weread-to-flomo

# weread-to-flomo Use this skill to move WeRead highlights/notes into flomo safely. ## Default workflow 1. Export WeRead notes into local Markdown files first. 2. Set `FLOMO_WEBHOOK` and `WEREAD_COOKIE` via environment variables or config files outside the skill package. 3. Choose one sync scope: - `today`: only today's new entries - `date`: entries from a specified day - `all`: full migration 4. Use local state tracking to avoid duplicate pushes. 5. Run `--dry-run` before the first real sync or before a bulk migration. 6. Prefer `today` or `date` mode when the user already has historical reading notes in flomo. ## Modes ### 1. Sync today's new entries ```bash 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 ```bash python3 ./scripts/weread_to_flomo.py --weread-dir /path/to/weread --mode date --date 2026-03-26 --flomo-webhook "$FLOMO_WEBHOOK" ``` ### 3. Full migration ```bash 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: ```text 内容正文 #02_读书 #02_读书/「书名」 ``` Override with: ```bash --tag-prefix "02_读书" ``` ## State and dedup - State file defaults to `.weread-flomo-state.json` under 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 `today` or `date` mode before `all`. ## References - Read `references/formatting.md` when adjusting output structure or tag conventions. - Read `references/publishing.md` when preparing the skill for ClawHub publication.