美股代码查询minyang-chen/dsh-stock-lookup

dsh-stock-lookup

一个 DeepSeek Harness 插件，为 agent 提供两个用于股票研究的工具：

- stock_resolve — 使用内置的 SEC EDGAR 公司索引（约 10,000 家公司），将公司名称或部分股票代码解析为美国股票代码。返回股票代码、CIK、官方公司名称以及直接的 SEC EDGAR 备案链接。
- stock_profile — 通过 Yahoo Finance 获取实时股票报价和公司简介（价格、涨跌幅、市盈率、市值、板块、行业、描述等）。

无需 API 密钥。除 Yahoo Finance 外无需外部服务。

安装

从 npm 安装（发布后）：
dsh plugin --profile web add dsh-stock-lookup

从 GitHub 安装（无需发布到 npm）：
dsh plugin --profile web add github:minyang-chen/dsh-stock-lookup

从本地克隆安装：
dsh plugin --profile web add /path/to/dsh-stock-lookup

安装后，重启 DSH：dsh web

更新到最新版本

从 GitHub 拉取最新提交并重新构建：
dsh plugin --profile web update dsh-stock-lookup

或者移除后重新添加：
dsh plugin --profile web remove dsh-stock-lookup
dsh plugin --profile web add github:minyang-chen/dsh-stock-lookup

更新后请重启 DSH。

工具

stock_resolve

将公司名称或股票代码解析为股票代码。

| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| query | string | ✅ | 公司名称、部分名称或股票代码。例如 "Apple"、"nvidia"、"TSLA" |
| limit | number | | 返回的最大结果数（1–10，默认 5） |

agent 的输出：
Found 1 match for "Apple":
• AAPL — Apple Inc. (CIK 320193)
SEC EDGAR: https://www.sec.gov/cgi-bin/browse-edgar?...

原始工具响应（JSON）

{
"status": "ok",
"data": [
{
"ticker": "AAPL",
"company": "Apple Inc.",
"cik": 320193,
"sec_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=320193&type=10-K..."
}
]
}

stock_profile

根据股票代码获取实时报价和公司简介。

| 参数 | 类型 | 必填 | 描述 |
|---|---|---|---|
| ticker | string | ✅ | 股票代码。例如 "AAPL"、"NVDA"、"BRK-B" |

agent 的输出：
Apple (AAPL) — $310.34 on Nasdaq, up $0.99 (+0.32%) from the previous close of $309.35,
as of the 2026-08-24 close.

Volume:        34.4M shares
Market cap:    ~$4.53T
52-week range: $224.69 – $344.57
Valuation:     trailing P/E 35.5, forward P/E 32.5, EPS (TTM) $8.75
Sector:        Technology — Consumer Electronics
Country:       United States

原始工具响应（JSON）

{
"status": "ok",
"data": {
"symbol": "AAPL",
"name": "Apple Inc.",
"exchange": "NasdaqGS",
"currency": "USD",
"price": 310.34,
"change": 0.99,
"change_percent": 0.32,
"previous_close": 309.35,
"market_cap": 4529157832704,
"trailing_pe": 35.47,
"forward_pe": 32.54,
"eps_trailing_twelve_months": 8.75,
"fifty_two_week_high": 344.57,
"fifty_two_week_low": 224.69,
"sector": "Technology",
"industry": "Consumer Electronics",
"country": "United States",
"description": "Apple Inc. designs, manufactures, and markets smartphones..."
}
}

使用示例

只需自然地询问智能体——它会自动选择合适的工具。

直接查询股票代码（智能体跳过 stock_resolve，直接调用 stock_profile）：
What is Apple's current stock price?

公司名称 → 股票代码 → 概况（双工具链）：
What sector is Nvidia in?
智能体调用 stock_resolve("nvidia") → 找到 NVDA → 调用 stock_profile("NVDA")。

名称有歧义：
Look up Amazon stock

获取 SEC EDGAR 申报链接：
Give me the SEC EDGAR filing link for Microsoft
智能体调用 stock_resolve("Microsoft") 并给出指向 EDGAR 申报文件的直接链接。

按名称查找多家公司：
Find all companies with "apple" in the name
最多返回 10 个匹配项，每项包含股票代码、CIK 和 EDGAR 链接。

典型智能体工作流程

User: "What is Nvidia's current stock price?"

Agent:
1. stock_resolve("nvidia") → finds NVDA
2. stock_profile("NVDA")  → returns live price + profile

配置

| 选项 | 默认值 | 描述 |
|---|---|---|
| enabled | true | 向智能体注册工具 |
| quoteTtlMs | 15000 | 报价缓存生存时间（毫秒） |

数据来源

- 股票代码解析：内置的 SEC EDGAR 公司股票代码——约 10,000 家美国上市公司。当 DSH 启动时，如果该数据超过 7 天，插件会自动从 SEC EDGAR 刷新。如果刷新失败（无网络、SEC 不可用），则使用内置副本作为回退。
- 实时报价与概况：Yahoo Finance，通过 yahoo-finance2

随时强制手动刷新：

npm run update-sec-data
git add data/company_tickers.json
git commit -m "chore: refresh SEC EDGAR company tickers"

许可证

MIT