git clone https://github.com/PanStories/free-and-cheap-tokens.git
cd free-and-cheap-tokens
npm ci
npm run build:catalog
npm run dev

{
  "mcpServers": {
    "free-and-cheap-tokens": {
      "command": "node",
      "args": ["dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "free-and-cheap-tokens": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://YOUR-APIFY-HOSTNAME/mcp", "--header", "Authorization: Bearer YOUR-APIFY-TOKEN"]
    }
  }
}

┌────────────────────────────────────────────────────────┐
│ GitHub Pages (零依赖静态)                              │
│  · index.html · styles.css · app.js · feed.xml · ics │
│  · og.png (CI 期 sharp 生成)                          │
└────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────┐
│ Apify Standby Actor (Streamable HTTP · stateless)    │
│  · Node 24.21.0 + Express 5 + MCP SDK 1.30.1          │
│  · Task hostname 256MB (不是 Actor 级 1024MB!)        │
│  · 每请求 Bearer token (mcp-remote 桥接)              │
└────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────┐
│ 同名 Skill (WorkBuddy / Claude)                       │
│  · 每日简报 + 实时查询                                │
│  · 走 MCP 原语                                        │
└────────────────────────────────────────────────────────┘

free-and-cheap-tokens/
├── .actor/                     Apify Actor 配置
├── .github/workflows/          CI: preflight / build-site / refresh
├── data/promos/                策展数据（每文件一条 promo）
├── docs/                       PRD / ARCHITECTURE / UIUX / 决策记录
├── design/                     Design Tokens（json + css）
├── schemas/                    promo.schema.json（Draft 2020-12，机器校验唯一源）
├── scripts/                      build-catalog / build-site / refresh / generate-og
├── site/                       构建产物（gitignored 除必要）
├── src/                        TypeScript 源码（MCP server / tools / tier）
├── tests/                      vitest 测试
├── SPEC.md                     规格即契约（zh-CN · [English →](SPEC.en.md)）
├── README.md                   ← 你在这（zh-CN · [English →](README.en.md)）
├── LICENSE                     MIT
└── CONTRIBUTING.md             收录流程（zh-CN · [English →](CONTRIBUTING.en.md)）

npm ci                  # 安装（含 devDeps）
npm run typecheck       # tsc --noEmit
npm run lint            # eslint
npm test                # vitest（schema 校验 + 业务逻辑）
npm run check:p0        # P0 红线（emoji / 紫粉渐变 / 回弹缓动 / 空洞占位）
npm run build:catalog   # 构建 build/catalog.json
npm run build:site      # 生成 site/ 全套
node scripts/generate-og.mjs  # 生成 site/og.png（需 sharp）
npm run preflight       # 一键跑完上面所有