notcrawl
Notion archive: desktop/API sync, Markdown export, page search, read-only SQL.
How do I install this agent skill?
npx skills add https://github.com/steipete/agent-scripts --skill notcrawlIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill interfaces with a local Notion archiving utility to search and query synced data. It accesses files in the user's home directory and processes external content from Notion, which introduces a surface for Indirect Prompt Injection. The SQL functionality is limited to read-only operations.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/steipete/agent-scripts/notcrawl">View notcrawl on skillZs</a>