ValueSider 超级投资者数据

基于美国证券交易委员会（SEC）13F 文件，动态从 ValueSider 获取价值投资者（Superinvestors）的投资组合及交易活动数据。实时流程：使用 web_fetch 抓取网页 → 通过脚本解析 → 返回 JSON 格式结果。

适用场景

• 用户查询某位超级投资者 / 投资大师的投资组合（例如 Warren Buffett、Mason Hawkins、Longleaf Partners）。
• 用户查询13F 持仓数据，或询问“[基金经理/基金] 持有哪些股票”。
• 用户查询买入/卖出活动（例如“[投资大师] 正在买入或卖出哪些股票”）。
• 用户在提及投资组合数据时明确提到ValueSider 或 valuesider.com。

实时流程（推荐）

ValueSider 常对直接发起的 HTTP 请求返回 403 错误。请使用 web fetch 获取页面内容，再通过脚本进行 解析。

步骤 1：解析投资大师 slug

• 若用户提供姓名（如 “Mason Hawkins”），可直接使用已知 slug（例如 mason-hawkins-longleaf-partners）；或调用 web_fetch 获取 https://valuesider.com/value-investors 页面，并从中查找匹配的链接（slug 即 URL 中 /guru/ 与 /portfolio 之间的路径部分）。
• 常见 slug 示例：warren-buffett-berkshire-hathaway、mason-hawkins-longleaf-partners、seth-klarman-baupost-group、bill-ackman-pershing-square-capital-management。

步骤 2：使用 web_fetch 抓取两个页面

• 投资组合页：https://valuesider.com/guru/{guru_slug}/portfolio
• 交易活动页：https://valuesider.com/guru/{guru_slug}/portfolio-activity

对每个 URL 分别调用 web_fetch（或等效方法），并保存其返回的纯文本内容。

步骤 3：将内容解析为 JSON

将投资组合页响应内容保存至临时文件（如 _portfolio.txt），交易活动页响应内容保存至 _activity.txt，然后执行：

# 从技能目录（valuesider-superinvestor-data/）中运行
python scripts/parse_fetched_content.py --type portfolio --file _portfolio.txt --guru-slug  --source-url "https://valuesider.com/guru//portfolio"
python scripts/parse_fetched_content.py --type activity --file _activity.txt --guru-slug  --source-url "https://valuesider.com/guru//portfolio-activity"

也可通过标准输入传入内容（无需 --file 参数）：

python scripts/parse_fetched_content.py --type portfolio --guru-slug mason-hawkins-longleaf-partners < _portfolio.txt

输出为 JSON 格式： - 投资组合数据包含 summary（摘要）和 holdings（持仓列表）； - 交易活动数据包含 activities（数组），每项含字段：quarter（季度）、ticker（股票代码）、stock_name（股票名称）、activity_type（操作类型）、share_change（股份数变动）、pct_change_to_portfolio（占组合变动百分比）、reported_price（申报价格）、pct_of_portfolio（占组合比例）。

步骤 4：呈现结果

简要总结 summary 字段（报告期、组合总值、持仓数量），并从解析后的 JSON 中列出前几大持仓，或最近的买入/卖出记录。所有数据均来自 ValueSider；请勿将其作为金融建议呈现。

替代方案：直连抓取脚本（适用于未返回 403 的环境）

若当前环境允许（例如无 403 限制），可使用基于 requests 的脚本：

# 列出投资大师（可能触发 403）
python scripts/fetch_valuesider.py --list-gurus --limit 100

# 抓取单个投资大师数据（可能触发 403）
python scripts/fetch_valuesider.py 
python scripts/fetch_valuesider.py  --portfolio-only
python scripts/fetch_valuesider.py  --activity-only

依赖要求：pip install -r requirements.txt（需安装 requests、beautifulsoup4）。若遇到 403 错误，请改用上方推荐的实时流程。

数据来源

• 投资组合数据：https://valuesider.com/guru/{guru_slug}/portfolio
• 交易活动数据：https://valuesider.com/guru/{guru_slug}/portfolio-activity
• 投资大师列表：https://valuesider.com/value-investors