notcrawl

---
name: notcrawl
description: "Use when working with notion archive: desktop/API sync, Markdown export, page search, read-only SQL from steipete/agent-scripts."
source: https://github.com/steipete/agent-scripts/tree/main/skills/notcrawl
generated: 2026-05-27T20:56:03.110Z
category: tool
audience: engineers
---

## When to use

- Local Notion archive questions. Desktop reads local cache; API sync needs NOTIONTOKEN and page access.
- Using the notcrawl skill's upstream workflow, guardrails, and local-tool assumptions.
- Auditing commands or operational steps before changing notcrawl behavior.
- Needing a compact agent reference for notion archive: desktop/API sync, Markdown export, page search, read-only SQL.

## Key concepts

### Sources

DB: ~/.notcrawl/notcrawl.db Pages: ~/.notcrawl/pages CLI: notcrawl.

### Refresh

Use API only when needed and credentials/page access are available:.

### 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:.

## API reference

```
npx skills add steipete/agent-scripts --skill notcrawl
```

Install the notcrawl skill from steipete/agent-scripts.

```
npx skills add steipete/agent-scripts --skill notcrawl
```

```
notcrawl doctor.
```

Command or snippet documented by the upstream notcrawl skill.

```
notcrawl doctor
notcrawl status
notcrawl sync --source desktop
```

```
notcrawl sync --source api.
```

Command or snippet documented by the upstream notcrawl skill.

```
notcrawl sync --source api
```

```
notcrawl search --limit 20 "query".
```

Command or snippet documented by the upstream notcrawl skill.

```
notcrawl search --limit 20 "query"
notcrawl databases
notcrawl sql "select count(*) from pages;"
notcrawl export-md
```

## Gotchas

- Read the upstream SKILL.md before use; several entries encode machine-specific paths, credentials, or local operational assumptions.

---
Generated by SkillMake from https://github.com/steipete/agent-scripts/tree/main/skills/notcrawl on 2026-05-27T20:56:03.110Z.
Verify against source before relying on details.

File: ~/.claude/skills/notcrawl/SKILL.md