mcpField
N
notcrawl

notcrawl

github.com/steipeteProductivity7.4k82 installsUpdated 1w ago
Repository

About notcrawl

notcrawl is a command-line skill for querying local Notion archives, intended for users who need to search pages or analyze databases. It syncs from the desktop cache or, with credentials and page access, the API, and supports search, read-only SQL, and Markdown export.

Key features

  1. 01Sync desktop cache or Notion API
  2. 02Search archived pages
  3. 03List databases
  4. 04Run read-only SQL queries
  5. 05Export Markdown files

Use cases

  1. 01Look up local Notion page content
  2. 02Check page or database record counts
  3. 03Review archive freshness
  4. 04Refresh Markdown export files

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/steipete/agent-scripts --skill notcrawl

After installing, type/notcrawlin Claude Code to confirm it loaded.

Details

From the project README

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

  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:

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

Comments

Markdown supported