newsletter-events-setup

为本地新闻稿事件插件设置环境。首次安装、更新依赖项或验证配置时使用。

📖 中文导读:为本地新闻稿事件插件设置环境。首次安装、更新依赖项或验证配置时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: newsletter-events-setup description: Set up environment for local newsletter events plugin. Use when first installing, updating dependencies, or verifying configuration.

## Environment Requirements

This plugin requires two runtimes:

Python 3.12+ with uv for:

  • Instagram scraping (ScrapeCreators API)
  • Event deduplication (rapidfuzz)
  • Newsletter generation (Jinja2)
  • Config validation (Pydantic)

Node.js 18+ with bun for:

  • Facebook event scraping (facebook-event-scraper npm)

Why Two Runtimes?

The facebook-event-scraper library is JavaScript-only with no Python equivalent. Rather than reimplement it, we use a subprocess bridge with strict JSON contracts.

Package Managers

  • uv: Fast Python package manager with lockfile support
  • bun: Fast JavaScript runtime and package manager

Both ensure reproducible environments via lockfiles (uv.lock, bun.lockb).

What do you need help with?
  1. Full setup - Install all dependencies from scratch
  2. Check environment - Verify everything is configured correctly
  3. Update dependencies - Update to latest compatible versions
  4. Troubleshoot - Debug environment issues

Wait for response before proceeding.

| Response | Workflow | |----------|----------| | 1, "setup", "install", "fresh" | `workflows/setup-environment.md` | | 2, "check", "verify", "status" | Run verification checks inline | | 3, "update", "upgrade" | Run `uv sync --upgrade` and `bun update` | | 4, "troubleshoot", "debug", "help" | Diagnose common issues | Environment is ready when: - [ ] `uv --version` returns 0.4.0+ - [ ] `bun --version` returns 1.0.0+ - [ ] `uv run python -c "import rapidfuzz"` succeeds - [ ] `bun run scripts/scrape_facebook.js --help` succeeds - [ ] `.env` file exists with `SCRAPECREATORS_API_KEY` set - [ ] `config/sources.yaml` exists and validates