SKILL.md
specter-cli
通过 specter-cli 从 Specter 情报平台获取、搜索和管理公司及人员数据。支持按域名查询公司、通过 LinkedIn 补全专业人士信息、管理列表、查询已保存的搜索项，以及追踪人才与投资者信号。

安装

克隆并安装 CLI：

git clone git@github.com:FroeMic/tryspecter-cli.git
cd tryspecter-cli
npm install
npm run build
npm link

设置 SPECTER_API_KEY 环境变量（可在 Specter 设置 > API 控制台中获取）：

• 推荐方式： 添加至 ~/.claude/.env（适用于 Claude Code）
• 替代方式： 添加至 ~/.bashrc 或 ~/.zshrc：export SPECTER_API_KEY="your-api-key"

代码仓库地址：git@github.com:FroeMic/tryspecter-cli.git

命令

公司补全与查询：

specter companies enrich --domain             # 按域名补全公司信息
specter companies enrich --linkedin              # 按 LinkedIn URL 补全公司信息
specter companies enrich --website               # 按官网 URL 补全公司信息
specter companies get                      # 根据 Specter ID 获取公司详情
specter companies similar                  # 查找相似公司
specter companies people                   # 获取公司团队成员
specter companies search                       # 按公司名称或域名搜索公司

人员补全与查询：

specter people enrich --linkedin                 # 按 LinkedIn 标识符补全人员信息
specter people get                          # 根据 Specter ID 获取人员详情
specter people email                        # 获取人员邮箱地址
specter people find-by-email                   # 通过邮箱反向查找人员

列表管理：

specter lists companies list                          # 列出所有公司列表
specter lists companies create                  # 创建公司列表
specter lists companies get                   # 获取列表元数据
specter lists companies results               # 获取列表中的公司
specter lists companies add                   # 向列表中添加公司
specter lists companies remove                # 从列表中移除公司
specter lists companies delete              # 删除公司列表
specter lists people list                             # 列出所有人列表
specter lists people create                     # 创建人员列表
specter lists people results                  # 获取列表中的人员
specter lists people delete                   # 删除人员列表

已保存的搜索项：

specter searches list                                 # 列出所有已保存的搜索项
specter searches delete                     # 删除已保存的搜索项
specter searches companies get              # 获取公司搜索详情
specter searches companies results          # 获取公司搜索结果
specter searches people get                 # 获取人员搜索详情
specter searches people results             # 获取人员搜索结果
specter searches talent get                 # 获取人才搜索详情
specter searches talent results             # 获取人才信号结果
specter searches investor-interest get      # 获取投资者兴趣搜索详情
specter searches investor-interest results  # 获取投资者兴趣结果

信号：

specter talent get                          # 获取人才信号详情
specter investor-interest get               # 获取投资者兴趣信号详情

实体抽取：

specter entities search --text "..."                  # 从文本中抽取公司/投资者
specter entities search --file                  # 从文件中抽取实体（最多 1000 字符）

全局选项：

--api-key        # 覆盖 SPECTER_API_KEY 环境变量
--format      # 输出格式：json（默认）、table、csv
--help                # 显示帮助信息
--version             # 显示版本号

核心概念

API 参考

• 基础 URL： https://app.tryspecter.com/api/v1
• 认证方式： X-API-KEY: $SPECTER_API_KEY
• 速率限制： 每个 API Key 每秒最多 15 次请求（自动重试，采用指数退避策略）
• 积分机制： 按团队分配配额，每次成功返回结果消耗 1 积分，每月重置

常用 API 操作

按域名补全公司信息：

curl -X POST https://app.tryspecter.com/api/v1/companies/enrich 
  -H "X-API-KEY: $SPECTER_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"domain": "example.com"}'

按 LinkedIn 补全人员信息：

curl -X POST https://app.tryspecter.com/api/v1/people/enrich 
  -H "X-API-KEY: $SPECTER_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"linkedin": "https://www.linkedin.com/in/johndoe"}'

搜索公司：

curl -X GET "https://app.tryspecter.com/api/v1/companies/search?query=acme" 
  -H "X-API-KEY: $SPECTER_API_KEY"

获取公司搜索结果：

curl -X GET "https://app.tryspecter.com/api/v1/searches/companies//results?page=0&limit=50" 
  -H "X-API-KEY: $SPECTER_API_KEY"

注意事项

• 已保存的搜索项必须在 Specter 平台上启用 “Share with API” 选项，才能通过 API 访问。
• 通过 API 创建的列表默认可共享；通过平台创建的列表需手动开启 “Share with API” 开关。
• 无法通过 API 创建已保存的搜索项，仅支持查询与删除。
• 公司 ID 格式为 comp_*，人员 ID 格式为 per_*。
• 分页使用 0 起始索引的 page 和 limit 查询参数（limit 最大值为 5000）。
• CLI 在遭遇限流时会自动重试最多 3 次，并采用指数退避策略。
• 调试期间可设置 DEBUG_API_ERRORS=true 以启用详细错误日志输出。