SEO关键词研究 (DataForSEO)

设置

安装依赖项：

pip install -r scripts/requirements.txt

通过在项目根目录下创建.env文件来配置凭据：

DATAFORSEO_LOGIN=your_email@example.com
DATAFORSEO_PASSWORD=your_api_password

从以下网址获取凭据：https://app.dataforseo.com/api-access

快速开始

通过从以下文件导入来执行函数：scripts/main.py：

import sys
from pathlib import Path
sys.path.insert(0, str(Path("scripts")))
from main import *

result = keyword_research("AI website builders")

工作流模式

每个研究任务遵循三个阶段：

1. 研究

运行 API 函数。每次函数调用都会请求 DataForSEO API 并返回结构化数据。

2. 自动保存

所有结果会自动保存为带时间戳的 JSON 文件到results/{category}/目录。文件命名模式：YYYYMMDD_HHMMSS__operation__keyword__extra_info.json

3. 总结

研究完成后，读取保存的 JSON 文件并在results/summary/目录中创建一个 Markdown 格式的总结，包含数据表格、排名靠前的机会以及战略建议。

高级函数

以下是scripts/main.py. 每个函数都协调多个API调用，以完成完整的研究工作流程。

参数

所有函数都接受一个可选的location_name参数（默认值："美国"）。大多数函数还具有布尔标志，用于跳过特定的子分析（例如，include_suggestions=False）。

单个API函数

如需精细控制，请从API模块导入特定函数。完整列表包含25个API函数及其参数、限制和示例，请参见references/api-reference.md。

结果存储

结果自动保存至results/目录，结构如下：

results/
├── keywords_data/    # Search volume, CPC, competition
├── labs/             # Suggestions, difficulty, intent
├── serp/             # Google/YouTube rankings
├── trends/           # Google Trends data
└── summary/          # Human-readable markdown summaries

管理结果

from core.storage import list_results, load_result, get_latest_result

# List recent results
files = list_results(category="labs", limit=10)

# Load a specific result
data = load_result(files[0])

# Get most recent result for an operation
latest = get_latest_result(category="labs", operation="keyword_suggestions")

实用函数

from main import get_recent_results, load_latest

# List recent files across all categories
files = get_recent_results(limit=10)

# Load latest result for a category
data = load_latest("labs", "keyword_suggestions")

创建摘要

运行研究后，在results/summary/包括：

• 数据表格包含搜索量、每次点击费用、竞争度和难度
• 机会排名列表（按搜索量或机会分数排序）
• 搜索结果页面分析展示当前排名情况
• 建议关于内容策略、标题、标签

为摘要文件取一个描述性名称（例如，results/summary/ai-tools-keyword-research.md）。

技巧

1. 具体明确— “获取‘AI网站构建工具’的关键词建议”比“研究AI相关内容”效果更好
2. 请求摘要— 研究后务必创建一份摘要文档，并明确命名
3. 批量处理相关关键词— 一次性输入多个相关关键词以便比较
4. 明确目标— “用于YouTube视频”与“用于落地页”所关注的核心数据会有所不同
5. 请求进行竞争分析——“展示排名靠前的视频”有助于识别内容空白

默认设置

• 地理位置：美国（代码2840）
• 语言：英语
• API限制：搜索量/概览分析支持700个关键词，难度/意图分析支持1000个，趋势分析支持5个，关键词创意生成支持200个