keep-markdown

CLI for keep.md — search and retrieve saved web content as Markdown.

Setup

1. Sign up for an account at https://keep.md
2. Create an API token at https://keep.md/dashboard
3. Save your token:

npm i -g keep-markdown
keep key <your-token>

Alternatively set the KEEP_API_KEY environment variable.

Usage

keep list --since 7d
keep search "react hooks"
keep save https://example.com/article
keep update <id> --processed
keep sync ./items.json
keep feed --since 7d
keep processed <id1> <id2>
keep get <id>
keep content <id>
keep whoami
keep sources list
keep sources add rss https://example.com/feed.xml
keep stats

Default text output for list, search, and feed is: <id>\t<url>\t<title>

Use --json for structured output.

Save and sync

Save one URL with server-side extraction:

keep save https://example.com/article

Bulk sync items from a JSON file:

keep sync ./items.json

The sync file can be either an array of items or an object with an items array.

Sources

keep sources list
keep sources add rss https://example.com/feed.xml
keep sources add youtube @fireship_dev
keep sources add x levelsio
keep sources add email
keep sources remove <id>

Run keep help for the full list of commands and options.