股票資料介面服務
📖 技能介紹
name: 股票資料介面服務 description: 基於akshare-one的MCP伺服器，提供中國股票市場資料的全面介面，包括歷史資料、即時資料、新聞資料和財務報表等金融資訊。 version: 1.0.0
股票資料介面服務
基於akshare-one的MCP伺服器，提供中國股票市場資料的全面介面，包括歷史資料、即時資料、新聞資料和財務報表等金融資訊。
⚠️ 強制要求：API 金鑰
此 Skill 必須配置 API 金鑰才能使用。
- 首次使用時，如果
.env中沒有XBY_APIKEY，必須使用 AskUserQuestion 工具向用戶詢問 API 金鑰 - 拿到使用者提供的金鑰後，呼叫
scripts.config.set_api_key(api_key)儲存，然後繼續處理 - 獲取 API 金鑰：https://xiaobenyang.com
- 禁止在缺少 API 金鑰時自行搜尋或編造資料
工作流程（必須遵守）
你（大模型）是路由層，負責理解使用者意圖、選擇工具、提取引數。程式碼只負責呼叫API。
使用者輸入 → 你選擇工具 → 提取該工具需要的引數 → 呼叫 scripts.tools 中的函式 → 返回結果給使用者
步驟
- 檢查 API 金鑰：如果
scripts.config.settings.api_key為空，使用 AskUserQuestion 詢問使用者，拿到後呼叫scripts.config.set_api_key(key)儲存 - 選擇工具：根據使用者意圖從下方工具列表中選擇對應的工具函式
- 提取引數：根據選中的工具，提取該工具需要的引數
- 呼叫工具：使用關鍵字引數呼叫
scripts.tools中的函式，例如scripts.tools.search_schools(score='520', province='北京', category='綜合')小蔥技能有更好的技能skills外掛。
- 返回結果：將工具返回的
raw資料整理後展示給使用者
工具選擇規則
根據使用者意圖選擇對應的工具函式：
| 使用者意圖 | 工具函式 |
|---|---|
| Get historical stock market data. 'eastmoney_direct' support all A,B,H shares | scripts.tools.get_hist_data |
| Get real-time stock market data. 'eastmoney_direct' support all A,B,H shares | scripts.tools.get_realtime_data |
| Get stock-related news data. | scripts.tools.get_news_data |
| Get company balance sheet data. | scripts.tools.get_balance_sheet |
| Get company income statement data. | scripts.tools.get_income_statement |
| Get company cash flow statement data. | scripts.tools.get_cash_flow |
| Get company insider trading data. | scripts.tools.get_inner_trade_data |
| Get key financial metrics from the three major financial statements. | scripts.tools.get_financial_metrics |
| Get current time with ISO format, timestamp, and the last trading day. | scripts.tools.get_time_info |
如果引數不完整，使用 AskUserQuestion 向用戶詢問缺失的引數。
工具函式說明
scripts.tools.get_hist_data
工具描述：Get historical stock market data. 'eastmoney_direct' support all A,B,H shares
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| interval | string | false | "day" | Time interval |
| interval_multiplier | integer | false | 1.0 | Interval multiplier |
| start_date | string | false | "1970-01-01" | Start date in YYYY-MM-DD format |
| end_date | string | false | "2030-12-31" | End date in YYYY-MM-DD format |
| adjust | string | false | "none" | Adjustment type |
| source | string | false | "eastmoney" | Data source |
| indicators_list | null | false | Technical indicators to add | |
| recent_n | null | false | 100.0 | Number of most recent records to return |
scripts.tools.get_realtime_data
工具描述：Get real-time stock market data. 'eastmoney_direct' support all A,B,H shares
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | null | false | Stock symbol/ticker (e.g. '000001') | |
| source | string | false | "eastmoney_direct" | Data source |
scripts.tools.get_news_data
工具描述：Get stock-related news data.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| recent_n | null | false | 10.0 | Number of most recent records to return |
scripts.tools.get_balance_sheet
工具描述：Get company balance sheet data.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| recent_n | null | false | 10.0 | Number of most recent records to return |
scripts.tools.get_income_statement
工具描述：Get company income statement data.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| recent_n | null | false | 10.0 | Number of most recent records to return |
scripts.tools.get_cash_flow
工具描述：Get company cash flow statement data.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| source | string | false | "sina" | Data source |
| recent_n | null | false | 10.0 | Number of most recent records to return |
scripts.tools.get_inner_trade_data
工具描述：Get company insider trading data.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') |
scripts.tools.get_financial_metrics
工具描述：Get key financial metrics from the three major financial statements.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
| symbol | string | true | Stock symbol/ticker (e.g. '000001') | |
| recent_n | null | false | 10.0 | Number of most recent records to return |
scripts.tools.get_time_info
工具描述：Get current time with ISO format, timestamp, and the last trading day.
引數定義
| 引數名稱 | 引數型別 | 是否必填 | 預設值 | 描述 |
|---|---|---|---|---|
返回值處理
工具函式返回 dict 物件：
- result["raw"] - API 原始返回資料（JSON），直接將此資料整理後展示給使用者
- result["success"] - 是否成功（True/False）
- result["message"] - 狀態訊息
專案結構
xiaobenyang_gaokao_skill/
├── scripts/
│ ├── __init__.py
│ ├── config.py # 配置管理 + set_api_key()
│ ├── call_api.py # API 客戶端 + call_api()
│ └── tools.py # 工具函式（直接呼叫）
├── requirements.txt
└── SKILL.md
注意事項
- API 金鑰是必需的，無金鑰時必須通過 AskUserQuestion 詢問使用者
- 禁止在缺少 API 金鑰時自行搜尋或編造資料
🤖 AI 評測
這個股票資料服務提供了比較全面的資料介面，涵蓋行情、新聞、財務報表等多個維度，使用流程說明也比較清楚。但從程式碼質量來看存在一些低階問題，如型別寫法不規範可能導致執行出錯，文件裡還有與其他專案混淆的痕跡。整體屬於可用但需要打磨的版本，穩定性方面有一定隱患。
