用途:把已保存的 DataForSEO 审计数据(由 /seo audit 生成)转换为排版精美的 PDF SEO 报告,便于交付客户。PDF 由 ReportLab 本地生成,不再发起额外 API 调用。
主要能力:封面含综合总分及 Keywords、Technical、Authority 评分卡片;执行摘要;关键指标块;按优先级配色标注的行动计划表;含搜索量、CPC、难度、排名的关键词机会表;竞争格局表。若审计 JSON 缺少某部分数据,对应章节会跳过,部分审计仍可生成有效 PDF。
使用方式:先运行凭证预检 ~/.claude/skills/seo/scripts/preflight.sh。退出码 0 表示已配置;退出码 2 时脚本会输出 DataForSEO 配置向导,需按其提示提供 login 与 password,写入 ~/.claude/skills/seo/.env 并 chmod 600,再用 ~/.claude/skills/seo/scripts/keyword_research.py volume "test" 验证。前置条件是 /seo audit <domain> 已运行并保存 ~/.claude/skills/seo/output/<domain>-audit.json,否则需先做审计。生成命令:~/.claude/skills/seo/scripts/generate_pdf_report.py --input ~/.claude/skills/seo/output/<domain>-audit.json --output ~/.claude/skills/seo/output/<domain>-report.pdf。生成后打印绝对路径,在 macOS 可用 open ~/.claude/skills/seo/output/<domain>-report.pdf 打开。
定制:修改 scripts/generate_pdf_report.py 顶部的 BRAND_PRIMARY、BRAND_ACCENT 等常量可调整颜色、字体和品牌样式。
限制:依赖先前的审计 JSON 与已配置的 DataForSEO 凭证;凭证不得回显或提交。资料未提供价格、平台兼容范围及效果保证等信息。