MyHomeware SEO 看板 · 业务参考文档 ← 全部文档打开线上页面 ↗

关键词汇总看板

页面地址:/pages/ · 站点:mhw.schwuaclawai.top

页面用途

全站首页,展示所有关键词的 SEO 运营总览:统计卡片、筛选、排序、分页列表。运营人员从此页进入各词的「单词 SEO 全景看板」。

业务定位

首页是全站 SEO 运营指挥台:回答三件事——现在有多少词、各区间排名分布如何、基础优化(TDH/内容/内链)与进阶外链各完成多少。运营从这里下钻到单词看板,编辑从右上角进控制台。

业务逻辑(深度)

1. 排名「双口径」与批次对齐

系统同时维护两种排名,讲解时务必区分:

可见批次日期 = keyword_ranking_logsMAX(check_date)。列表只展示该日期的排名;若该日 SerpAPI 任务仍在跑,页面会提示批次未就绪,但逻辑上仍对齐「最新一期」数据。

101 表示未进前 100,UI 显示为「—」;周环比 = 上一检查日 target_url_rank − 当前(正值表示排名提升)。

2. 统计卡片怎么算

卡片判定逻辑(讲解要点)
域名排名区间人数全词库 LEFT JOIN 可见批次当日排名;1–3 / 4–10 / 11–20 / 21–29 / 30–100 互斥;NULL/101 → 未上榜。点击区间给列表加 domain_bucket 筛选。
TDH / 内容 / 内链 / InfoHub各计划表按 tdh_statusstatus 分桶:已完成(含「已上线」「已有无需更新」)/ 进行中 / 待进行。
基础优化完成四表同时满足:TDH=已完成 + 内容∈{已完成,已上线,已有无需更新} + 常规内链∈{已完成,已上线} + InfoHub∈{已完成,已上线}。缺一即不算「基础完成」。
基础优化进行中任一为「进行中」,且尚未达到上面「四表全完成」。
进阶 · 外链分母=总词数;分子=至少有一条 backlink_details 锚文本与关键词完全匹配(忽略大小写)的词数。

3. 列表行与优化进度

每行 JOIN 五张维度表(TDH/内容/常规内链/InfoHub/外链计数)。进度圆点映射:

排序:默认 created_at ASC(先录入先展示);可按 content/internal/infohub 维度状态排序(已完成=3、进行中=2、待进行=1)。

4. 典型运营路径

  1. 周一:确认 ranking-job 批次完成 → 首页看域名区间是否整体上移。
  2. 筛「基础优化进行中」→ 进单词看板盯 TDH/内容/内链。
  3. 筛 TOP 4–10 → 重点做内链策略与内容补强冲 TOP 3。
  4. 无排名词 → 先确认 target_url 是否正确、是否已进抓取队列。

5. 边界与常见误解

应用接口

接口方法参数返回
/pages/?api=1GET pagelimitsearchsortdirdomain_bucket { data, total, has_more }

详细字段映射见 docs/data-mapping-list.md

数据库表

keywords_basic、keyword_ranking_logs、onpage_tdh_records、onpage_content_records、internal_link_plans、infohub_link_plans、backlink_details

关键代码

pages/index.phpincludes/ranking_display.php