用途：通过 DataForSEO API 完成 SEO 关键词研究，覆盖关键词分析、YouTube 关键词研究、竞品分析、SERP 分析与趋势追踪。
安装与配置：先执行 pip install -r scripts/requirements.txt，再在项目根目录创建 .env 文件，填入 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD；凭据可从 https://app.dataforseo.com/api-access 获取。
主要能力：scripts/main.py 提供高层函数，包括 keyword_research(keyword) 单关键词深挖、youtube_keyword_research(keyword) YouTube 内容研究、landing_page_keyword_research(keywords, competitor_domain) 落地页 SEO、full_keyword_analysis(keywords) 内容规划、competitor_analysis(domain, keywords) 竞品情报、trending_topics(location_name) 当前趋势。函数可传 location_name（默认 United States），部分支持布尔开关跳过子分析。
使用方式：从 scripts/main.py 导入函数调用，例如 keyword_research("AI website builders")。每次调用会请求 API 并返回结构化数据，结果自动以时间戳 JSON 保存到 results/{category}/，命名格式为 YYYYMMDD_HHMMSS__operation__keyword__extra_info.json。之后可读取 JSON 在 results/summary/ 生成含数据表、机会排序与建议的 Markdown 摘要。可用 core.storage 的 list_results、load_result、get_latest_result 管理结果。
限制：默认位置美国（代码 2840）、语言英语；API 限制为 volume/overview 700 个关键词、difficulty/intent 1000 个、trends 5 个、keyword ideas 200 个。更细粒度控制可参考 references/api-reference.md 中的 25 个 API 函数。