What does notcrawl do?
Use this for local Notion archive questions. Desktop reads local cache; API sync needs NOTION_TOKEN and page access.
Sources
- DB:
~/.notcrawl/notcrawl.db - Pages:
~/.notcrawl/pages - CLI:
notcrawl
Refresh
notcrawl doctor
notcrawl status
notcrawl sync --source desktop
Use API only when needed and credentials/page access are available:
notcrawl sync --source api
Query Workflow
- Check freshness for recent/current Notion questions.
- Search pages first; use read-only SQL for exact counts or schema-level analysis.
- Use
export-mdwhen the user needs Markdown files refreshed. - Report date spans, page/database IDs, counts, and source limits.
Use root or subcommand help for syntax: notcrawl --help,
notcrawl search --help, notcrawl sql --help.
Common commands:
notcrawl search --limit 20 "query"
notcrawl databases
notcrawl sql "select count(*) from pages;"
notcrawl export-md