🚀 SiteFlow - 出海网站开发工作流系统

专业的出海工具站开发解决方案：从关键词研究到网站盈利的完整自动化流程

🎯 项目概述

SiteFlow是一个专为出海工具站设计的端到端开发工作流系统，通过8个标准化阶段，从关键词研究到网站盈利，帮助开发者快速构建高质量、SEO友好的工具网站。

✨ 核心特性

🔍 智能关键词研究 - KDRoI算法优化，避坑检测机制
📋 标准化需求管理 - INVEST原则用户故事，技术规范明确
🏗️ 自动化代码生成 - Finwise风格模板，响应式设计
🔧 SEO优化集成 - 页面级+技术级SEO，性能达标保证
💰 变现策略内置 - Adsense合规，高CPC关键词挖掘
📊 质量关卡自动化 - A/B/C/D/F评分体系，失败重试机制

🚀 快速开始

前置要求

Node.js 18+
Git
Claude Code CLI
Google账号 (Search Console, Analytics, Adsense)

快速获取SiteFlow配置

方式1: 使用tiged快速安装 (推荐)

# 快速获取SiteFlow完整配置到当前项目
npx tiged Dimon94/cc-siteflow/.claude .claude

# 验证安装成功
ls .claude/

方式2: 克隆完整项目

# 克隆项目
git clone https://github.com/Dimon94/cc-siteflow.git
cd cc-siteflow

# 或复制配置到已有项目
cp -r cc-siteflow/.claude your-project/.claude

启动项目

⚠️ 重要提醒: 按照最新要求，必须提供真实数据源

# 新的5参数命令格式 (v2.0+)
/siteflow-new "SITE-001|phone number generator|semrush_export.csv|US|$1000"

# 参数说明:
# 1. SITE-ID: 项目标识符 (SITE-XXX格式)
# 2. KEYWORD: 主目标关键词
# 3. DATA_SOURCE: Semrush/Ahrefs数据源 (必需真实数据)
# 4. TARGET_MARKET: 目标市场 (US/UK/CA/AU等)
# 5. REVENUE_GOAL: 月收入目标 ($500/$1000等)

# 查看项目状态
/siteflow-status "SITE-001"

数据准备清单 📋

启动项目前，请确保准备好：

🔑 SEO工具数据 (必需)

# Semrush导出步骤:
# 1. 登录 semrush.com → Keyword Magic Tool
# 2. 输入种子词，设置筛选: KD≤30, Volume≥1000
# 3. 导出CSV文件: semrush_export.csv

🌍 市场目标 (必需)
- 目标市场: US/UK/CA/AU/EU
- 收入目标: $500/$1000/$5000
- 竞品网站列表 (3-5个)
🔐 账户准备 (部署时需要)
- Vercel账户 (免费即可)
- Google账户 (Search Console, Analytics)
- 域名或域名偏好

📋 工作流概览

SiteFlow采用8个标准化阶段的线性工作流：

graph LR
    A[RESEARCH<br/>市场研究] --> B[REQUIREMENTS<br/>需求分析]
    B --> C[PLANNING<br/>技术规划]
    C --> D[DEVELOPMENT<br/>网站开发]
    D --> E[SEO_OPTIMIZATION<br/>SEO优化]
    E --> F[DEPLOYMENT<br/>部署上线]
    F --> G[MONETIZATION<br/>变现配置]
    G --> H[GROWTH<br/>增长优化]

🔍 阶段1: 市场研究 (RESEARCH)

目标: 验证关键词机会，分析竞争格局
工具: keyword-researcher 代理
输出: 关键词分析报告、竞品分析报告
质量关卡: ≥5个A级关键词，避坑检测通过

📝 阶段2: 需求分析 (REQUIREMENTS)

目标: 将市场研究转化为产品需求文档
工具: prd-writer 代理
输出: 标准化PRD文档
质量关卡: INVEST原则用户故事，技术要求明确

📊 阶段3: 技术规划 (PLANNING)

目标: 将PRD分解为可执行任务
工具: planner 代理
输出: EPIC文档、原子任务分解
质量关卡: 任务≤1天，依赖关系清晰

🛠️ 阶段4: 网站开发 (DEVELOPMENT)

目标: 开发高质量SEO友好网站
工具: 主代理 + Finwise模板
输出: 完整网站代码
质量关卡: PageSpeed≥90分，SEO配置完整

🔧 阶段5: SEO优化 (SEO_OPTIMIZATION)

目标: 全面SEO配置和优化
工具: seo-monetization-analyst 代理
输出: SEO审计报告、优化方案
质量关卡: SEO评分≥85分，技术配置完整

🚀 阶段6: 部署上线 (DEPLOYMENT)

目标: 网站安全部署并配置监控
工具: 主代理
输出: 线上运行网站
质量关卡: HTTPS正常，监控配置完成

💰 阶段7: 变现配置 (MONETIZATION)

目标: 配置Adsense和变现策略
工具: seo-monetization-analyst 代理
输出: 变现分析报告、广告配置
质量关卡: Adsense申请完成，合规检查通过

📈 阶段8: 增长优化 (GROWTH)

目标: 外链建设和持续优化
工具: seo-monetization-analyst 代理
输出: 外链建设计划、增长报告
质量关卡: 获得10个高质量外链，排名进入前50

🤖 专业代理体系

研究型代理

keyword-researcher

关键词研究专家

🔍 Semrush/Ahrefs关键词扩展
📊 KDRoI计算 (Volume×CPC÷KD)
⚠️ 避坑检测 (季节词、直达答案、视频墙)
🏆 竞品SERP分析

seo-monetization-analyst

SEO变现分析师

🔧 技术SEO全面检查
💵 高CPC词汇挖掘
📊 Adsense优化策略
🔗 外链机会分析

开发型代理

prd-writer

产品需求文档专家

📋 INVEST原则用户故事
🎯 技术规范明确定义
💰 变现策略集成
🔍 SEO要求嵌入

planner

技术规划师

⚛️ 原子任务分解 (≤1天)
🔗 依赖关系管理
⏱️ 时间估算优化
✅ 验收标准定义

🎨 设计系统

SiteFlow采用现代化的Finwise设计风格：

🎨 色彩系统

主色调: #FED835 (黄色) - 活力与创新
辅助色: #304fff (蓝色) - 专业与信赖
背景色: #F3F3F5 (浅灰) - 简洁与清晰

📱 响应式设计

移动优先设计理念
断点: 640px / 768px / 1024px / 1280px
Grid网格背景效果
现代渐变与阴影

⚡ 性能优化

Core Web Vitals优化
图片WebP格式
代码分割与懒加载
CDN缓存策略

🛡️ 质量保证

自动化质量关卡

SiteFlow内置A/B/C/D/F评分体系：

# 质量检查函数示例
validate_research_stage() {
  local site_id="$1"
  local score=0

  # 关键词质量检查
  if [[ $(get_a_grade_keywords_count) -ge 5 ]]; then
    score=$((score + 25))
  fi

  # 避坑检测
  if [[ $(check_pitfall_detection) == "passed" ]]; then
    score=$((score + 25))
  fi

  # 竞品分析完整性
  if [[ $(check_competitor_analysis) == "complete" ]]; then
    score=$((score + 25))
  fi

  # 收益预期评估
  if [[ $(check_revenue_estimation) == "realistic" ]]; then
    score=$((score + 25))
  fi

  echo $score
}

质量标准

指标	要求	验证方式
PageSpeed Insights	≥90分	自动化测试
SEO评分	≥85分	技术审计
移动友好性	100%通过	Google测试
Core Web Vitals	全绿	性能监控
Adsense合规	100%通过	政策检查

📊 KDRoI算法

SiteFlow的核心创新 - KDRoI (Keyword Difficulty Return on Investment):

// KDRoI计算公式
function calculateKDRoI(volume, cpc, difficulty) {
  // 特殊处理: KD=0时使用KD=1避免除零错误
  const kd = difficulty === 0 ? 1 : difficulty;

  return (volume * cpc) / kd;
}

// 优先级分类
function getKeywordPriority(kdroi) {
  if (kdroi > 100) return 'A'; // 立即执行
  if (kdroi >= 50) return 'B'; // 优先考虑
  return 'C'; // 低优先级
}

🚫 避坑机制

SiteFlow内置5大避坑检测：

季节词陷阱 🌟
- Google Trends检查
- 波动>70%需谨慎
直达答案陷阱 💡
- Featured Snippet检测
- SERP分析验证
视频墙陷阱 📺
- YouTube占据检查
- 前5位视频比例
品牌词陷阱 🏢
- 品牌名称识别
- 商标风险评估
极高KD陷阱 ⚡
- KD>70超高竞争
- ROI不可行分析

💰 变现策略

Adsense优化

📍 广告位置: 头部横幅 + 内容中部
👤 用户体验: 广告不影响核心功能
✅ 合规要求: 遵循所有Adsense政策
💵 高CPC策略: 目标CPC>$0.5

收益目标

🎯 月收入目标: >$500
📈 流量目标: >10,000 UV/月
🏆 ROI目标: >300%
📊 排名目标: 前20位

🗂️ 项目结构

.claude/
├── CLAUDE.md                           # 核心工作流文档
├── commands/                           # SiteFlow命令
│   ├── siteflow-new.md                # 新建项目命令
│   └── siteflow-status.md             # 项目状态命令
├── rules/                             # SiteFlow规则系统
│   ├── siteflow-data-exchange.md      # 数据交换标准
│   ├── siteflow-monetization-compliance.md  # 变现合规
│   ├── siteflow-orchestrator.md       # 工作流编排
│   ├── siteflow-path-manager.md       # 路径管理
│   ├── siteflow-quality-gates.md      # 质量关卡
│   ├── siteflow-quality-standards.md  # 质量标准
│   └── siteflow-seo-requirements.md   # SEO要求
├── agents/                            # 核心代理系统
│   ├── keyword-researcher.md          # 关键词研究专家
│   ├── seo-monetization-analyst.md    # SEO变现分析师
│   ├── prd-writer.md                  # 产品需求文档作者
│   └── planner.md                     # 技术规划师
└── docs/templates/                    # SiteFlow专用模板
    ├── FINWISE_STYLE_TOOL_TEMPLATE.html    # Finwise风格工具模板
    ├── SITEFLOW_WEBSITE_TEMPLATE.html      # SiteFlow网站模板
    └── SITEFLOW_PROJECT_STATUS_TEMPLATE.md # 项目状态模板

🔧 技术栈

默认技术栈

前端: HTML5 + CSS3 + Vanilla JavaScript
部署: Vercel + Cloudflare
分析: Google Search Console + Google Analytics
变现: Google Adsense
监控: PageSpeed Insights + 自定义监控

性能要求

Core Web Vitals: LCP≤2.5s, FID≤100ms, CLS≤0.1
移动友好性: 100%通过Google测试
压缩: 图片WebP格式，代码Gzip压缩
缓存: CDN缓存策略优化

📚 使用示例

启动新项目

# 案例1: 工具词项目 (美国市场，高收入目标)
/siteflow-new "SITE-001|phone number generator|semrush_phones.csv|US|$1000"

# 案例2: 转换器项目 (英国市场，中等收入目标)
/siteflow-new "SITE-002|pdf to word converter|ahrefs_pdf.csv|UK|$500"

# 案例3: 计算器项目 (澳洲市场，保守收入目标)
/siteflow-new "SITE-003|bmi calculator|semrush_health.csv|AU|$300"

# 案例4: 多市场项目 (欧盟市场，积极收入目标)
/siteflow-new "SITE-004|color picker tool|ahrefs_design.csv|EU|$2000"

快速上手完整流程 🚀

# 1. 获取SiteFlow配置
npx tiged Dimon94/cc-siteflow/.claude .claude

# 2. 准备SEO数据 (必需步骤)
# - 登录Semrush.com
# - 导出关键词数据为CSV
# - 确保包含: Keyword|Volume|KD|CPC字段

# 3. 启动项目 (示例)
/siteflow-new "SITE-001|password generator|semrush_security.csv|US|$800"

# 4. 监控进度
/siteflow-status "SITE-001"

# 5. 响应各阶段数据需求提示
# SiteFlow会在每个阶段提示您提供必要的数据

状态监控

# 查看项目状态
/siteflow-status "SITE-001"

# 输出示例:
# ✅ RESEARCH (100%) - 5个A级关键词已识别
# ✅ REQUIREMENTS (100%) - PRD文档已完成
# 🔄 PLANNING (60%) - 任务分解进行中
# ⏳ DEVELOPMENT (0%) - 等待上一阶段完成

🎯 成功案例

关键指标

📈 30天上线: 从关键词到盈利网站
🚀 PageSpeed 95+: 性能优化达标
🎯 排名前20: 目标关键词达成
💰 月收入$500+: 变现目标实现

🤝 贡献指南

Fork 项目
创建特性分支 (git checkout -b feature/amazing-feature)
提交更改 (git commit -m 'Add amazing feature')
推送到分支 (git push origin feature/amazing-feature)
开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

🙏 致谢

Claude Code - AI驱动的开发工具
Finwise - 设计系统灵感
Semrush - 关键词研究数据
Ahrefs - SEO分析工具

📞 支持与联系

📧 Email: support@siteflow.dev
💬 Discord: SiteFlow Community
📖 Documentation: docs.siteflow.dev
🐛 Issues: GitHub Issues

🚀 让出海网站开发变得简单高效

Made with ❤️ by the SiteFlow Team

开始使用 • 查看文档 • 加入社区

Name		Name	Last commit message	Last commit date
Latest commit History 3 Commits
.claude		.claude
README.md		README.md
siteflow_agent.md		siteflow_agent.md

Dimon94/cc-siteflow

Folders and files

Latest commit

History

Repository files navigation