007 全球加密货币返佣平台 / cryptorebate

• 中文名：全球加密货币返佣平台
• 英文名：cryptorebate
• 类型：Web 产品 / 增长 / 联盟返佣 / 商业化
• 当前状态：进行中（可构建、可部署、持续优化）

项目目标

做一个“先比较，再注册”的可信返佣决策站点：让用户在注册交易所前，先看清返佣比例、手续费、KYC 门槛和适配人群，再通过邀请链接行动。

最近进展（本轮）

• 交易所数据扩展到 7 家（含 KuCoin / Huobi）
• 多语言扩展到 11 语种（默认英语，保留简体中文）
• 品牌资产与页面接入完成（wordmark / mark / icon / OG 图）
• SEO/GEO 内容集群扩展到 6 类子页：referral-code、signup-kyc、fees-rebate、official-site、app-download、safety-review
• 线上 sitemap.xml 已纳入 462 个 GEO 路径，并已重新提交给 Google Search Console
• 搜索发现层已补齐更多自动化入口：
  • brand-sitemap.xml
  • fresh-7d-sitemap.xml
  • feed.xml
  • Search Console API 自动提交上述 sitemap / feed
• 最小后端闭环已补齐：GET /api/exchanges 与 POST /api/clicks
• 分析采集已加 consent gate：用户同意前不初始化 PostHog，也不发送点击日志
• SEO/GEO 自动化闭环已接入：opportunities、pages、ROI、earnings、control APIs、daily automation snapshot
• GSC 真实 OAuth/拉取与 7 家交易所 partner earnings 外部同步框架已接入，当前只差生产环境凭据与数据源 URL
• click → registration → commission 归因摘要已补到 automation state 与 /api/stats/seo
• /en/admin/seo 已新增 CTA / GSC / Partner 最近状态卡、7 家交易所真实度分布、失败趋势、最近 7 天变化
• /en/admin/seo 现在会优先走 DB-first operator payload，并显示 Telegram / X 自有渠道分发队列状态
• 所有交易所 partner 接入策略已统一收口为 affiliate-first：默认按月初 CSV 导出/导入，API/broker 仅作为高级可选方案
• 新增部署与质量门禁：
  • web/vercel.json：强制 www -> apex 301
  • web/package.json：新增 npm run check 与 Vercel 一键部署命令
  • .github/workflows/quality-gates.yml：PR / Push 自动跑 lint + test + build
  • .github/workflows/automation-loop.yml：每日自动跑 SEO/GEO automation pipeline 并提交新 snapshot

当前覆盖

• 交易所（7）：Binance、OKX、Bybit、Bitget、Gate.io、KuCoin、Huobi/HTX
• 语言（11）：en、zh、zh-tw、ja、ko、ru、es、pt、vi、th、hi
• 主域名策略：cryptorebate.app 为主域，www.cryptorebate.app 永久 301 到主域
• GEO 子页规模：7 exchanges × 6 page types × 11 locales = 462

关键文档

• INDEX.md
• PRD-v1.md
• information-architecture-v1.md
• growth-and-seo-v1.md
• seo-geo-automation-architecture-v1.md
• revenue-tracking-v1.md
• risk-guardrails-v1.md
• launch-plan-p0-v1.md
• real-data-vs-simulated-v1.md
• admin-console-operator-guide-v1.md
• partner-source-spec-v1.md
• automation-alerts-runbook-v1.md
• brand-assets-usage.md
• logo-redesign-brief.md
• logo-generation-prompts.md
• logo-wordmark-spec.md
• web/README.md

代码入口

• web/（Next.js App Router）

快速命令

cd web
npm run check
npm run dev
npm run automation:generate
npm run automation:sync-gsc
npm run automation:submit:sitemaps
npm run automation:sync-earnings
npm run partner:import:csv -- --exchange okx --file /absolute/path/to/okx.csv
npm run deploy:vercel   # safe from web/, delegates to repo root
bash scripts/sync-automation-secrets.sh   # push automation envs to GitHub + Vercel

外部自动源（GSC / Partner Earnings）

• GSC 真实拉取已支持两种模式：
  • Service Account
  • Refresh Token
• GSC 现在还支持自动提交：
  • sitemap.xml
  • brand-sitemap.xml
  • fresh-7d-sitemap.xml
  • feed.xml
• 自有渠道分发队列已接入：
  • Telegram：配置 bot token + chat id 后自动发布
  • X：配置 user access token 后自动发布
  • 未配置时保留为 pending 队列，统一展示在 /en/admin/seo
• partner earnings 已升级为 provider-aware 外部同步：
  • 默认主路径：csv-portal（月初 affiliate CSV 导出/导入）
  • 次选：generic（affiliate portal 如果有固定 JSON / CSV 报表链接）
  • 高级可选：okx-broker、gate-api4
• 月初 CSV 导入正式命令：
  • cd web && npm run partner:import:csv -- --exchange okx --file /absolute/path/to/okx.csv
  • cd web && npm run partner:import:csv:dry-run -- --exchange binance --file /absolute/path/to/binance.csv
• 本地环境变量样例见：web/.env.example
• GitHub Actions 每日 automation loop 已支持读取对应 secrets 并回写：
  • web/src/data/generated/gsc-query-signals.json
  • web/src/data/generated/partner-conversions.json
  • web/src/data/generated/partner-commissions.json
  • web/src/data/generated/external-sync-state.json

上线口径

• Vercel 项目 Root Directory 设为 web
• 当前正式生产项目名为 cryptorebate
• 推荐发布入口：在仓库根目录运行 npx vercel --prod，或在 web/ 目录运行 npm run deploy:vercel（会自动回到根目录）
• 发布前必须先通过 npm run check
• www.cryptorebate.app 通过 Vercel 永久重定向收口到 https://cryptorebate.app