介绍
# CEORater Skill
通过 CEORater API 查询标普 500 (S&P 500) 及美国主要上市公司的 CEO 绩效数据。
## 前置条件
1. 在 https://www.ceorater.com/api-docs.html 获取 API 密钥（每位用户 $99/月） 2. 设置环境变量：`CEORATER_API_KEY=zpka_your_key_here`
**许可说明：** 自助 API 访问仅限于个人研究和分析。将 CEORater 数据集成到专有公司模型、AI/ML 训练或构建产品中需要签署企业协议 — 请联系 [email protected]。
## 可用指标
| 指标 | 范围 | 描述 | |--------|-------|-------------| | CEORaterScore | 0-100 | CEO 综合效能评级 | | AlphaScore | 0-100 | 相对于市场基准的表现 | | RevenueCAGRScore | 0-100 | 任期调整后的收入增长百分位 | | CompScore | A-F | 薪酬效率等级 | | TSR During Tenure | % | CEO 任期内的总股本回报 | | TSR vs. S&P 500 | % | 相对于标普 500 (SPY) 的表现 | | CEO Compensation | $M | 最近一次代理委托文件中的总薪酬 | | Revenue CAGR | % | 任期调整后的复合年收入增长率 |
## API 端点
### 通过代码获取 CEO 信息 ```bash curl -H "Authorization: Bearer $CEORATER_API_KEY" \ "https://api.ceorater.com/v1/ceo/AAPL?format=raw" ```
### 搜索 CEO ```bash curl -H "Authorization: Bearer $CEORATER_API_KEY" \ "https://api.ceorater.com/v1/search?q=technology&format=raw" ```
### 列出所有 CEO ```bash curl -H "Authorization: Bearer $CEORATER_API_KEY" \ "https://api.ceorater.com/v1/ceos?limit=100&format=raw" ```
### 获取元数据（实时记录数 + 最后刷新时间戳） ```bash curl -H "Authorization: Bearer $CEORATER_API_KEY" \ "https://api.ceorater.com/v1/meta" ```
## 使用说明
当用户询问 CEO 绩效、评级或高管薪酬时：
1. **单名 CEO 查询：** 使用 `/v1/ceo/{ticker}` 端点 2. **行业/板块分析：** 使用 `/v1/search?q={query}` 3. **批量数据：** 使用 `/v1/ceos?limit=N`
请始终使用 `format=raw` 以获取适合计算的数值。
### 查询示例
- "Tim Cook 的 CEORaterScore 是多少？" → GET /v1/ceo/AAPL - "向我展示科技板块的 CEO" → GET /v1/search?q=technology - "谁是评分最高的 CEO？" → GET /v1/ceos，按 ceoraterScore 排序 - "对比 Tim Cook 和 Satya Nadella" → GET /v1/ceo/AAPL 和 /v1/ceo/MSFT
## 响应格式
```json { "companyName": "Apple Inc.", "ticker": "AAPL", "sector": "Technology", "industry": "Computer Manufacturing", "ceo": "Tim Cook", "founderCEO": false, "ceoraterScore": 87, "alphaScore": 93.5, "revenueCagrScore": 75.2, "revenueCagr": 0.042, "compScore": "C", "tsrMultiple": 22.23, "tenureYears": 14.4, "avgAnnualTsrRatio": 1.55, "compPer1PctTsrMM": 0.482, "tsrVsSpyRatio": 15.64, "avgAnnualVsSpyRatio": 1.09, "compensationMM": 74.6 } ```
## 错误处理
| 代码 | 含义 | |------|---------| | 401 | 缺失或无效的 API 密钥 | | 404 | 未找到代码 | | 400 | 错误的请求参数（例如，搜索时缺少 `q`）| | 429 | 速率受限，请使用退避重试 |
## 辅助脚本
为方便起见，可使用 `{baseDir}/scripts/ceorater.sh`：
```bash # Get single CEO {baseDir}/scripts/ceorater.sh get AAPL
# Search {baseDir}/scripts/ceorater.sh search "healthcare"
# List top N {baseDir}/scripts/ceorater.sh list 20 ```
## 数据覆盖范围
- 500+ 名 CEO，包括标普 500 成分股 - 实时记录数和刷新时间戳可通过 `GET /v1/meta` 获取 - 工作日美股收盘后每日更新 - 缓存响应最多安全期为 24 小时
## 更多信息
- 文档：https://www.ceorater.com/api-docs.html - Agent 清单：https://www.ceorater.com/.well-known/agent.json - 支持：[email protected] - 企业销售：[email protected]