SEO优化

适用场景

1 官网产品页收录差，需要快速诊断TDK、H标签、内容密度问题

2 内容团队批量生产文章后，自动审查关键词布局与内链结构

3 电商详情页流量下滑，排查页面加载速度、结构化数据、移动适配问题

4 竞品页面反超，对比分析标题策略、语义相关词覆盖与外部链接差距

核心Prompt（安装配置用）

你是企业级SEO优化Agent，专注于对指定页面进行技术性SEO诊断与内容优化建议。你的任务：接收用户提供的页面URL或页面HTML片段，以及目标关键词，输出结构化SEO优化报告。分析维度包括：1）TDK（标题、描述、关键词）是否包含目标词且长度合规；2）H1-H3标签层级是否合理，H1是否唯一且含核心词；3）正文关键词密度是否在1%-2.5%之间，是否存在堆砌；4）图片alt属性缺失情况；5）内链数量与锚文本分布；6）URL结构是否简洁含关键词；7）移动端适配与页面加载速度相关标签；8）结构化数据（Schema）覆盖情况。输出格式要求：先给出SEO健康分（0-100），再按严重、建议、可选三级列出问题，每个问题包含位置、现状、修改建议、预期影响。约束条件：不编造页面实际数据，若信息不足需明确标注“需进一步抓取”；建议必须可执行，避免泛泛而谈；不涉及黑帽SEO手段；对关键词堆砌、隐藏文本等违规操作直接标记为高风险。每次输出不超过800字，优先处理影响收录与排名的高优先级问题。

所需工具 / API对接

需要对接：1）网页抓取API（如Scrapy/Playwright服务）获取页面HTML；2）Google Search Console API或百度搜索资源平台API获取收录与点击数据；3）PageSpeed Insights API获取加载速度；4）SEO第三方API（如Ahrefs/SEMrush）获取关键词与外链数据；5）企业CMS或Git仓库写入优化建议。

安装部署步骤

11. 环境准备：确认服务器Python 3.10+，安装Docker与docker-compose，开放80/443端口，准备域名与SSL证书。

22. 安装依赖：执行 pip install requests beautifulsoup4 playwright fastapi uvicorn，并运行 playwright install chromium 安装浏览器内核。

33. 配置参数：在 config.yaml 中填写 target_domain、target_keywords、gsc_api_key、pagespeed_api_key，设置 crawl_depth: 2、max_pages: 50。

44. 导入Prompt：将 core_prompt 写入 prompts/seo_agent.txt，并在 agent_config.json 中引用路径，设置 temperature: 0.2。

55. 连接工具API：配置 GSC 服务账号JSON、PageSpeed API Key，测试 curl 调用返回200；对接CMS写入接口，配置 webhook_url。

66. 测试验证：运行 python -m seo_agent --url https://example.com/product --keyword "企业CRM"，检查输出是否含健康分与三级问题列表，核对抓取数据与页面实际一致。

77. 上线部署：使用 docker-compose up -d 启动服务，配置Nginx反向代理，设置每日凌晨2点定时任务 celery beat 执行全站扫描。

88. 监控告警：接入Prometheus监控任务成功率，失败时通过企业微信/钉钉机器人发送告警。

配置参数

参数名	说明	默认值
`target_domain`	待分析的目标域名	https://www.example.com
`target_keywords`	目标关键词列表，逗号分隔	企业CRM,客户管理
`crawl_depth`	页面抓取深度	2
`max_pages`	单次最大分析页面数	50
`keyword_density_min`	关键词密度下限	1.0
`keyword_density_max`	关键词密度上限	2.5
`output_language`	报告输出语言	zh-CN

效果示例

输入：URL=https://example.com/crm，目标关键词=企业CRM。Agent抓取页面后输出：SEO健康分68。严重问题：H1缺失，页面标题“首页-公司官网”未含关键词，建议改为“企业CRM系统_客户管理软件-公司名”；描述标签为空，需补充120字含关键词描述。建议问题：正文关键词密度0.6%，低于1%，建议在首段与H2中自然增加“企业CRM”出现3-4次；图片alt全部缺失，需补充。可选问题：内链仅2条，建议增加至5条相关产品页锚文本。预期影响：标题与H1修复后，预计2-4周收录率提升，目标词排名进入前3页。

常见问题

问：Agent能否直接修改网站页面？答：默认只输出建议，不直接修改。如需自动写入，需对接CMS API并开启write_mode，且建议先人工审核。
问：支持百度还是Google？答：两者都支持。GSC API对应Google，百度需对接搜索资源平台API，配置项中切换 search_engine 参数即可。
问：关键词密度如何计算？答：按目标词总出现次数除以正文总词数，中文按分词后词频统计，结果保留两位小数。
问：抓取被网站屏蔽怎么办？答：检查robots.txt与User-Agent配置，建议使用企业自有域名白名单或配置代理IP池。
问：报告太长怎么处理？答：可设置 max_report_length 参数，或开启 summary_only 模式仅输出健康分与严重问题。

企业落地建议

建议采用容器化私有部署，初期单机Docker即可，成本约每月200-500元云服务器费用，若需大规模抓取可增加代理IP与队列服务。部署时注意：1）遵守目标网站robots协议，控制抓取频率避免被封；2）SEO建议需与内容、技术团队确认后再执行，避免误改；3）建议先选10-20个核心页面试点，验证效果后再全站推广；4）定期更新关键词库与竞品数据，保持分析准确性。需要我们帮你落地吗？可以试试免费AI诊断→