用途：比较机构管理人已申报的13F持仓，用于组合集中度、持仓重叠或持有人名单研究。需先设置CRAWLORA_API_KEY，优先使用已连接的Crawlora MCP工具，否则使用随附的scripts/crawlora.sh，向https://api.crawlora.net/api/v1发送x-api-key。具体方法与参数见reference/endpoints.md。
主要能力：从已存储持仓中发现管理人/发行人分面值；manager_cik为精确管理人过滤，不是发行人代码或公司CIK；issuer_name/cusip查询为尽力而为的持有人发现，无权威CUSIP到公司CIK映射，需先核实类别与身份。已存储搜索返回各管理人最新索引申报；实时sec_institutional_holdings也返回最新13F-HR，上限1000。两者均不提供任意季度的结构化组合历史，历史比较需实际可比的已保存申报。
用法示例：scripts/crawlora.sh /datasets/sec-institutional-positions/facets facet=manager；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。
限制：这些是延迟申报持仓，非完整当前组合或实时交易。数据集页面有10000条结果窗口，实时计数可能小于total_holdings。空数据集可能仅表示无索引数据。比较时需用CUSIP加证券类别、share_type、put_call，分开处理期权、普通/优先类别与份额/本金，不可将所有股份加总为持股比例。实时解析器保留源表数值，不提供通用换算比例；未验证申报单位时不得套用千美元乘数，绝对美元总额应标记为未验证。不得推断交易日期、投资者意图、当前公司持股比例、空头敞口或投资业绩。遇认证错误应停止，429应退避，瞬时上游失败可重试一次。