项目背景
跨境独立站团队通常同时运营多个站点，GSC 数据、关键词、TDK、竞品分散在各处，难以集中管理与对比。Tophoo SEO 以「一个网站项目 = 一套独立 SEO 数据」为核心，把 SEO 日常操作集中到一套工作台中。
已实现功能
项目与账户
- 用户、工作区、套餐与项目权限管理；
- 项目管理：创建、切换当前项目，导出单个项目 Markdown 信息；
- 全部业务数据均绑定
site_project_id；切换项目后 GSC、任务、关键词、竞品、TDK 自动切换，不会混用； - 套餐项目额度：免费版 3 个项目，专业版 10 个项目。
GSC 数据分析与管理周报
- 手动导入四类基础数据：GSC 效果数据、网页索引编制、内链数据、外链数据；
- 六类收录问题 URL 明细：已抓取未编入索引、已发现未编入索引、404、noindex、403、重复规范页；
- 生成管理周报 Excel：收录现状/趋势、收录问题明细、链接数量、流量、热门查询/页面/地区、环比变化、风险与需要支持；
- 周报命名
SEO周报_YYYY_MM_DD.xlsx；根据 GSC 数据自动生成周报分析任务，支持状态更新与 Excel 导出。
关键词布局
- 无限层级关键词目录树：展开/收缩、分类原地编辑、新增子分类、同级上移/下移、递归删除；
- 关键词字段：关键词、中文翻译、月搜索量；支持标题模糊查询、分类关联、项目级去重；
- Excel 导入三种模式：智能更新、合并新增、清空后重新导入；支持导出 Excel 或 Markdown。
竞品分析
- 当前项目竞品列表：名称、网址、简介与自定义排序；表格内直接编辑，支持增删与上下移动；
- 导出命名：
项目名称_竞品列表_YYYY_MM_DD。
产品 TDK 与文章 TDK
- 分模块导入、浏览、模糊查询与导出；严格按标准 Excel 表头导入，以
wp_id排序； - 同一项目相同
wp_id自动覆盖更新，避免重复数据； - WordPress XML 转换工具已迁入对应模块；
- 导出命名带项目名与日期，例如
项目名称_产品_TDK_YYYY_MM_DD.xlsx。
技术栈
- 后端：Python 3.12、FastAPI、Uvicorn、SQLAlchemy、PyMySQL
- 前端：Jinja2、HTML、CSS、原生 JavaScript
- 数据处理：OpenPyXL、WordPress XML
- 数据库：MySQL
- 认证：JWT、PBKDF2-HMAC
设计亮点
- 数据隔离：GSC 相关表统一
gsc_import_前缀，核心业务记录带site_project_id并在接口层校验权限； - 去重策略：关键词按
(site_project_id, normalized_keyword)去重；TDK 按(site_project_id, wp_id)去重； - 性能：为导入批次、每日指标、维度指标、收录快照、任务、关键词树与 TDK 状态查询补充组合索引，启动时安全检查并创建缺失索引；
- utf8mb4：导入表与数据表统一 utf8mb4，可保存 WordPress 内容中的 emoji 与 4 字节特殊字符。
状态与 Roadmap
- 当前状态：核心功能已实现，支付为模拟收银台（测试开通，不产生真实扣款）；
- Roadmap：接入真实支付（Stripe/支付宝 Webhook 验签）、Alembic 迁移、TDK 过万条后列表分页、10 万级标题搜索（MySQL FULLTEXT）、GA4 分析模块。
本项目为个人自研工具，欢迎交流 SEO 工具化思路：联系我。