notcrawl
Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.
Source facts
- Repository
- steipete/agent-scripts
- Last source activity
- May 23, 2026 at 08:13
- Detected SKILL.md language
- English
- Stars
- 7,433
- Forks
- 648
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- notcrawl
- description
- Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.
# notcrawl
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
```bash
notcrawl doctor
notcrawl status
notcrawl sync --source desktop
```
Use API only when needed and credentials/page access are available:
```bash
notcrawl sync --source api
```
## Query Workflow
1. Check freshness for recent/current Notion questions.
2. Search pages first; use read-only SQL for exact counts or schema-level analysis.
3. Use `export-md` when the user needs Markdown files refreshed.
4. 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:
```bash
notcrawl search --limit 20 "query"
notcrawl databases
notcrawl sql "select count(*) from pages;"
notcrawl export-md
```
View on GitHub