安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install institutional-ownership-research
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 institutional-ownership-research。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

机构持仓研究使用 Crawlora 的实时 SEC 和已存储持仓工具，检查所选管理人申报的13F持仓，或识别某发行人的申报持有人。它帮助开发者和研究人员评估集中度、比较持仓重叠情况，并整理持有人候选名单，同时不丢失重要的申报和证券细节。
此 Openclaw Skills 工作流程将13F数据视为延迟发布的申报快照，而非完整的当前投资组合或实时交易。它会明确显示申报覆盖范围、来源溯源信息、截断情况、股份类别和价值单位假设，确保结论基于数据实际能够支持的内容。

应用场景

比较所选机构管理人申报的持仓。
使用尽力而为的发行人名称或 CUSIP 搜索，识别某发行人的申报持有人。
在所需分母和价值尺度有效时，计算申报中的持仓权重或集中度。
衡量返回持仓之间的重叠情况，同时明确披露结果不完整或持仓缺失的情况。
分析前核查申报身份、报告日期和申报日期、accession 编号及来源溯源信息。
整理申报持有人候选名单，但不得将快照视为当前持有情况或投资意图。

工作原理

确认研究方向：所选管理人的投资组合、发行人持有人发现、集中度或重叠情况。
设置 Crawlora API 密钥，并在可用时使用已连接的 Crawlora MCP 工具；否则调用随附的 shell 客户端。
发现管理人或发行人的 facet 值，并使用正确的标识符。manager_cik 用于标识管理人，而非发行人。
检索已存储的索引持仓或实时最新的13F-HR，然后记录申报标识符、日期、来源 URL 以及检索或抓取时间。
检查 HTTP 状态和应用程序 code；从 data 读取结果。遵守结果限制，并明确说明截断情况或索引结果为空的情况。
使用 CUSIP、证券类别、share_type 和 put_call 谨慎匹配持仓；保留投资裁量信息和存在歧义的行。
仅比较兼容的报告期间和价值单位。在最终研究结果中披露公式、覆盖范围、未解决的关联及限制。

配置指南

将 CRAWLORA_API_KEY 设置为你的 Crawlora API 密钥。
如果代理环境提供了所列的 Crawlora MCP 工具，优先使用这些工具。否则使用 scripts/crawlora.sh，它会将密钥发送至 Crawlora API。
查看 reference/endpoints.md，了解准确的端点方法和参数。
先使用 facets 发现管理人值，然后根据需要查询已存储持仓或实时 SEC 持仓端点。
export CRAWLORA_API_KEY="YOUR_CRAWLORA_API_KEY"
scripts/crawlora.sh /datasets/sec-institutional-positions/facets facet=manager

Replace with a discovered manager CIK:

scripts/crawlora.sh /datasets/sec-institutional-positions/search manager_cik="$MANAGER_CIK" page=1 page_size=100
scripts/crawlora.sh /sec/institutional-holdings cik="$MANAGER_CIK" limit=1000
遇到身份验证错误时停止；收到 HTTP 429 响应时退避；上游出现暂时性故障时重试一次。请求范围和额度应保持在指定范围内。

数据架构

此技能依赖 Crawlora 已存储持仓和实时 SEC 持仓响应。应保留来源字段和分析假设，而不要将不同概念混为一谈。
数据元素 处理指南
管理人身份 使用 manager_cik 进行精确的管理人筛选；不要将其与发行人股票代码或公司 CIK 混淆。
发行人和证券身份 保留发行人名称、CUSIP、证券类别、share_type 和 put_call；仅匹配发行人名称无法确定股份类别。
申报溯源信息 分别保留 accession、报告日期、申报日期、来源 URL 以及收集或抓取时间。
持仓属性 在理解其会计依据之前，保留投资裁量信息和看似重复的行。不要不加区分地合并期权、普通股或优先股类别，以及股份或本金金额。
价值和单位 保留原始 value 数值及单位假设。数据集文档说明单位为千美元，但在应用乘数或比较美元总额之前，应核实底层申报的计量尺度。
覆盖范围和完整性 已存储数据集页面的结果窗口为10,000条。受数量限制时，实时 count 可能低于 total_holdings。记录截断、计数缺失和索引结果为空的情况；数据集为空并不能证明不存在持仓。
历史范围 已存储搜索和实时持仓均返回最新索引申报或最新13F-HR。两者都不提供任意季度投资组合历史的结构化数据；只能比较实际保存且可比的申报。
对于按统一比例缩放的单份申报，即使返回的持仓遭到截断，也可以使用该申报的完整汇总总额，按 value / total_value 计算持仓权重。应标明分子的持仓定义，绝不能用前N项小计替代完整投资组合分母。计算完整集合的加权重叠情况，要求集合完整且可比，并且单位兼容。

高级特性

同时支持已连接的 Crawlora MCP 工具和随附的
scripts/crawlora.sh
API 客户端。
将已存储索引持仓搜索与实时最新13F-HR检索相结合；实时请求的
limit
最大为1000。
使用管理人 facets 发现筛选值，并支持精确的
manager_cik
筛选。
保留申报 accession 和时间元数据，以便按 accession 核对已刷新的管理人数据。
明确说明结果窗口、截断、不完整的重叠情况，以及尚未解决的发行人或 CUSIP 关联。
根据 CUSIP、证券类别、股份类型和看跌/看涨标记，谨慎匹配持仓。
避免对交易日期、投资者意图、公司当前持股比例、空头敞口或业绩作出缺乏依据的断言；此工作流程不会发起交易或账户操作。

name: institutional-ownership-research description: Compare reported institutional-manager 13F holdings through Crawlora live SEC and stored position tools. Use for portfolio concentration, reported-position overlap, or issuer-holder evidence with manager identity, filing lag, truncation, security class, and value units preserved.

Institutional ownership research

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound requests by the requested scope and credit budget. Preserve source IDs, URLs, source dates, and retrieval/crawl times separately.

Describe reported 13F positions for selected managers or an issuer. Establish manager versus issuer direction, the requested reporting period, and whether concentration, overlap, or a holder shortlist is needed. These are delayed reported positions, not complete current portfolios or real-time trades.

Resolve managers and filing scope

Discover manager/issuer facet values from stored positions. manager_cik is an exact manager filter; it is not the issuer's ticker or company CIK. issuer_name/cusip queries are best-effort holder discovery: no authoritative CUSIP-to-company-CIK join is supplied, so verify class and identity before joining.
Stored search returns each manager's latest indexed filing. Live sec_institutional_holdings also returns the latest 13F-HR, with a maximum limit of 1000. Neither route offers a structured arbitrary-quarter portfolio history. Historical comparison needs actual comparable saved filings, not a fictional period parameter or presumed previous-quarter values.
Preserve accession, report date, filing date, source URL, and collection/crawl time. Refresh selected managers and reconcile by accession; different filing dates or quarters cannot be merged silently. Submissions/filing metadata help locate documents and versions but do not return historical parsed holdings.
Dataset pages have a 10,000-result window; live count can be less than total_holdings because of the requested limit. Keep completeness visible. An empty dataset may mean no indexed data, not absence of an institution's position.
scripts/crawlora.sh /datasets/sec-institutional-positions/facets facet=manager

# Use a discovered manager CIK, for example:
# scripts/crawlora.sh /datasets/sec-institutional-positions/search manager_cik="$MANAGER_CIK" page=1 page_size=100
# scripts/crawlora.sh /sec/institutional-holdings cik="$MANAGER_CIK" limit=1000

Compare positions without changing their meaning

Use CUSIP plus security class, share_type, and put_call for comparable positions. Keep options, common/preferred classes, and share/principal amounts separate; do not sum all shares into a stock ownership percentage. Preserve investment discretion and duplicate-looking rows until their accounting basis is understood. A matching issuer name alone cannot resolve share classes.

The live parser preserves source table value numbers; it does not supply a universal conversion scale. Dataset documentation describes thousands of USD, but do not apply that multiplier to every filing or source without verifying its reported units. Retain raw units/assumptions, and mark absolute dollar totals unverified if the underlying filing's scale cannot be established. Cross-manager value comparisons require compatible units and reporting periods.

For a uniformly scaled single filing, position weight = value / total_value can use the same filing's full summary total even when returned holdings are truncated; label the numerator's actual position definition. Never replace that denominator with a top-N subtotal and call it whole-portfolio concentration. For incomplete overlap, show returned-position overlap and missing counts; full-set weighted overlap requires compatible units and complete comparable sets.

Return identity/filing coverage, comparable position rows, disclosed formulas, concentration/overlap scope, and unresolved joins. Do not infer trade dates, investor intent, current company ownership percentages, short exposure, or investment performance from these snapshots. No trading or account action is part of this research request.

投资者匹配研究
预测共识比较