steipete/notcrawl

Archivo de Notion: sincronización de escritorio/API, exportación a Markdown, búsqueda de páginas, SQL de solo lectura.

¿Qué es notcrawl?

Esta herramienta permite trabajar con un archivo local de Notion, sincronizando páginas desde la aplicación de escritorio o mediante la API de Notion. Es ideal para desarrolladores y usuarios avanzados que necesitan realizar consultas rápidas, búsquedas de contenido o análisis estructurados sin depender de la interfaz web. Soporta exportación a Markdown, consultas SQL de solo lectura y comandos CLI como `notcrawl search`, `notcrawl sql` o `notcrawl export-md`. Su funcionamiento se basa en una base de datos local (`~/.notcrawl/notcrawl.db`) y almacena las páginas en `~/.notcrawl/pages`. Para la sincronización por API se requiere configurar la variable de entorno `NOTION_TOKEN` y tener los permisos adecuados. Es compatible con plataformas de escritorio y entornos de línea de comandos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/notcrawl

Installed? Explore more Investigación y análisis de datos skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace notcrawl?

Úsalo para responder preguntas sobre el archivo local de Notion. La lectura desde el escritorio usa la caché local; la sincronización por API necesita NOTION_TOKEN y acceso a las páginas.

Fuentes

  • DB: ~/.notcrawl/notcrawl.db
  • Páginas: ~/.notcrawl/pages
  • CLI: notcrawl

Actualizar

notcrawl doctor
notcrawl status
notcrawl sync --source desktop

Usa la API solo cuando sea necesario y tengas las credenciales y acceso a las páginas:

notcrawl sync --source api

Flujo de consulta

  1. Verifica la actualización de los datos para preguntas recientes o actuales de Notion.
  2. Busca páginas primero; usa SQL de solo lectura para conteos exactos o análisis de esquema.
  3. Usa export-md cuando el usuario necesite archivos Markdown actualizados.
  4. Informa sobre rangos de fechas, IDs de páginas y bases de datos, conteos y límites de las fuentes.

Usa la ayuda de nivel raíz o de subcomando para la sintaxis: notcrawl --help, notcrawl search --help, notcrawl sql --help.

Comandos comunes:

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

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Skills relacionados