What makes StockEarning notable?

1.1K downloads. Trust evidence available

How should StockEarning be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

StockEarning

这是 StockEarningCN 的技能(Skill)。安装本技能，你将获得将自己的持仓通过习惯的AI助手进行更新和统计的能力。目前支持A股、B股、港股和美股。如果要获得API Key，请访问https://www.mystockearning.cn。

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.1k

Updated

Oct 11, 2026

Version

1.0.8

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 11, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 11, 2026
Adoption signal: 1.1K downloadsadoption · observed Oct 11, 2026
Latest release: 1.0.8release · observed Jun 21, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17fgqjct259919a6mhth0bex985vpzx:secn

Install using `clawhub skill install s17fgqjct259919a6mhth0bex985vpzx:secn` in an isolated environment before connecting it to live workloads.
No published capability contract is available yet, so validate auth and request/response behavior manually.
Review the upstream CLAWHUB listing at https://clawhub.ai/hareluya/secn before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-hareluya-secn/snapshot"

Documentation

CLAWHUB

123,571 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

market-data/SKILL.md

---
name: market-data
description: 专门用于查询全球股票实时价格、基本信息和搜索股票代码的助手。
metadata: {"openclaw": {"requires": {"env": ["STOCK_API_KEY"]}}}
user-invocable: true
---

# 市场数据助手 (Market Data)

专门用于查询全球股票实时价格、基本信息和搜索股票代码的助手。

## 认证与基础配置
- 环境变量: `STOCK_API_KEY`
- Base URL: 从 `config.sh` 中读取 `$STOCK_BASE_URL`（默认 `https://www.mystockearning.cn`，切换域名只需改 `config.sh`）

## 市场代码 (Market Codes)
- 美股: `us`
- 港股: `hk`
- A股: `cn_a`
- B股: `cn_b`

## API 指令清单

### 搜索股票
当用户说 "查询腾讯的代码" 或 "寻找苹果股票" 时：
- 执行 `./scripts/search_stocks.sh`（需要设置 `QUERY`，可选 `MARKET`）

### 获取实时价格
当用户说 "查看 AAPL 的现价" 时：
- 执行 `./scripts/get_price.sh`（需要设置 `SYMBOL`，可选 `MARKET`）

### 获取股票详情
当用户需要股票的基本面信息时：
- 执行 `./scripts/get_info.sh`（需要设置 `SYMBOL`，可选 `MARKET`）

## 执行规则
1. 解析用户指令。
2. **货币显示规则**：在回复实时价格或任何金额时，必须根据该股票所在的市场显示正确的货币符号或单位：
   - `cn_a` (A股): `¥` 或 `元` (人民币 CNY)
   - `hk` (港股): `HK$` 或 `港元` (港币 HKD)
   - `us` (美股): `$` 或 `美元` (美元 USD)
3. 构造对应的 `curl` 命令并执行。
4. 如果返回 404，告知用户未找到该股票，请检查名称或市场代码。
5. 将 JSON 格式的价格和货币单位转换为易读的自然语言，金额必须带上正确的货币单位。

portfolio-assistant/SKILL.md

---
name: portfolio-assistant
description: 专门用于查询用户持仓、盈亏情况和历史交易记录的助手。
metadata: {"openclaw": {"requires": {"env": ["STOCK_API_KEY"]}}}
user-invocable: true
---

# 投资组合助手 (Portfolio Assistant)

专门用于查询用户持仓、盈亏情况和历史交易记录的助手。

## 认证与基础配置
- 环境变量: `STOCK_API_KEY`
- Base URL: 从 `config.sh` 中读取 `$STOCK_BASE_URL`（默认 `https://www.mystockearning.cn`，切换域名只需改 `config.sh`）

## API 指令清单

### 获取当前持仓
当用户问 "我现在的苹果股票赚了多少钱？" 或 "查看我的美股持仓" 时：
- 获取特定股票持仓：执行 `./scripts/get_position_by_symbol.sh`（需要设置 `SYMBOL`）
- 获取某市场的所有持仓（按盈亏比例降序）：执行 `./scripts/get_positions_by_market_sorted.sh`（需要设置 `MARKET`）

### 获取交易记录
当用户问 "我最近一个月买过哪些美股？" 时：
- 执行 `./scripts/get_trades.sh`（需要设置 `MARKET`、`TRADE_TYPE`）

### 获取投资表现摘要
当用户问 "我账户总资产多少？" 或 "总盈亏如何？" 时：
- 获取收益摘要：执行 `./scripts/get_summary.sh`

## 执行规则
1. 解析用户指令。
2. **货币显示规则**：在回复任何持仓市值、成本或盈亏金额时，必须根据该股票或账户所在的市场显示正确的货币符号或单位：
   - `cn_a` (A股): `¥` 或 `元` (人民币 CNY)
   - `hk` (港股): `HK$` 或 `港元` (港币 HKD)
   - `us` (美股): `$` 或 `美元` (美元 USD)
3. 执行 `curl` 请求。
4. 从响应中提取关键字段（如 `profit_loss`, `profit_loss_percent`, `market_value`）。
5. 使用带颜色的 Markdown 格式或表格输出结果（如：盈利标红或绿，根据当地市场习惯），金额必须保留两位小数并带上正确的货币单位。

SKILL.md

---
name: secn
description: 这是 StockEarningCN 的 OpenClaw 技能/Skill插件入口说明。安装本目录后，你将获得一组可组合使用的技能
user-invocable: true
---
# StockEarningCN Skills介绍(StockEarning Assistant)

这是 StockEarningCN 的 OpenClaw 技能插件入口说明。安装本目录后，你将获得一组可组合使用的技能，用于：

- 查询A股行情、股票信息、股票搜索
- 查询与管理持仓、计算盈亏、刷新持仓现价
- 记录买入/卖出交易

## 开始之前：

您需要去`https://www.mystockearning.cn注册一个账号，并等待审核通过后获取api key。`

## 认证与基础配置

- 环境变量: `STOCK_API_KEY`
- Base URL: 从 `config.sh` 中读取 `$STOCK_BASE_URL`（默认 `https://www.mystockearning.cn`，也可通过环境变量 `STOCK_BASE_URL` 覆盖）

所有请求均使用 HTTP Header：`X-API-Key: $STOCK_API_KEY`

推荐安全保存（OpenClaw/Hermes 通用）：使用 `./scripts/setup_api_key.sh` 生成本地密钥文件（默认写入 `~/.config/stockearning/stockearning.env`，权限 600）。

## 推荐使用方式

通常直接使用主入口技能：

- `/secn`：主入口，覆盖最常用的查询/记账场景

若你希望更可控、更聚焦的行为，可以按需调用下列技能：

| 技能名称                  | 功能                 | 目录                       |
| --------------------- | ------------------ | ------------------------ |
| `secn`               | 主入口：综合查询、记录交易        | `./stock-master/`        |
| `portfolio-assistant` | 仅查询持仓/收益摘要/历史交易    | `./portfolio-assistant/` |
| `market-data`         | 仅查询实时价格、股票信息、搜索代码  | `./market-data/`         |
| `trade-execution`     | 仅用于记录买入/卖出交易       | `./trade-execution/`     |

## 安装方式

### Openclaw:

```
openclaw skills install secn
```

<br />

### Hermes:

```
hermes skills install clawhub:secn
```

stock-master/SKILL.md

---
name: secn
description: 主入口：包含查询持仓、行情、记账所有功能。
user-invocable: true
script: "bash scripts/run.sh"
---

# StockEarning 主投资助手 (Master Agent)

你是一个专业的股票投资组合助手。你可以通过调用 StockEarning 的 REST API 来帮助用户查询市场数据、管理持仓和记录交易。

## 工具使用方式

你现在拥有一个专门的 `run.sh` 脚本来执行所有的 API 调用。该脚本会自动处理环境变量（API Key）的读取和提示。

### 调用格式
你需要使用本技能目录下的 `./scripts/*.sh` 脚本完成各类操作（每个操作一个脚本文件）。

### 1. 查询持仓与收益 (Get Positions & Summary)
获取用户当前的股票持仓信息或整体收益。
- 获取所有持仓：执行 `./scripts/positions_all.sh`
- 获取特定股票的持仓：执行 `./scripts/positions_by_symbol.sh`（需要设置 `SYMBOL`）
- 获取整体收益摘要：执行 `./scripts/summary.sh`

### 2. 市场数据 (Market Data)
查询实时股价或搜索股票代码。
- 查询实时价格：执行 `./scripts/get_price.sh`（需要设置 `SYMBOL`，可选 `MARKET`）
- 搜索股票代码：执行 `./scripts/search_stocks.sh`（需要设置 `QUERY`，可选 `MARKET`）

### 3. 记录交易与券商配置 (Trade & Broker)
帮用户记录买卖行为及检查/配置券商。
- 检查某市场是否已配置券商：执行 `./scripts/get_brokers.sh`（需要设置 `MARKET`）
- 一键导入市场默认券商：执行 `./scripts/seed_defaults.sh`（需要设置 `MARKET`）
- 预计算手续费：执行 `./scripts/calculate_commission.sh`（需要设置 `BROKER_ID`、`TRADE_TYPE`、`QUANTITY`、`PRICE`）
- 记录买入/卖出交易：执行 `./scripts/create_trade.sh`（需要设置 `SYMBOL`、`NAME`、`MARKET`、`TRADE_TYPE`、`QUANTITY`、`PRICE`、`TRADE_DATE`；可选 `COMMISSION`、`CURRENCY`、`NOTES`）

### 4. 持仓盘点修正 (Position Adjustment)
如果因为分红、送转或其他原因导致持仓数量对不上，可以通过此接口直接调整**股数**。
注意：调整数量**不会修改历史成本价**，系统会自动生成一笔 `trade_type=adjust` 的交易记录用于流水追溯，其价格默认为当天的市价（若无则取原成本价）。
```bash
{baseDir}/scripts/edit_position.sh 123 1050 "分红送转调整"
```

## 严格执行规则
1. 分析用户输入。
2. **货币显示规则**：在回复任何金额（如价格、手续费、总额、盈亏）时，必须根据该股票所在的市场显示正确的货币符号或单位：
   - `cn_a` (A股): `¥` 或 `元` (人民币 CNY)
   - `hk` (港股): `HK$` 或 `港元` (港币 HKD)
   - `us` (美股): `$` 或 `美元` (美元 USD)
3. **记录交易的智能补全与券商机制**：当用户想要记录交易时，你必须按照以下逻辑处理：
   - **(代码补全)**：如果没有代码，先调 `GET /api/positions/` 查持仓；没找到则调用搜索 API (`/api/markets/search/stocks`) 遍历 cn_a, hk, us。
   - **(清仓智能识别)**：如果用户说“清仓”、“全卖了”，且未提供数量，必须先调用 `GET /api/positions/` 获取该股票的当前持仓数量，并自动填入。
   - **(防爆仓拦截)**：如果是卖出操作且提供了数量，必须先调用 `GET /api/positions/` 检查余额。如果余额不足，直接拒绝并提示用户当前实际持有量。
   - **(市价智能获取)**：如果用户未提供**买入价格**，静默调用 `/api/markets/stocks/{symbol}/price` 获取当前市价，并作为默认建议价询问用户。
   - **(按金额反推数量)**：如果用户提供了总金额和单价但未提供数量，自动计算 `数量 = 向下取整(总金额 / 单价)` 并向用户确认。
   - **(券商前置拦截与算费)**：在发起最终交易前，必须执行以下步骤：
     1. 调用 `GET /api/brokers/?market={对应的市场}`。
     2. 如果返回空列表 `[]`，说明该市场无券商。你必须**拦截交易并暂停**，询问用户：“您在这个市场尚未配置券商。是否需要为您一键导入该市场的默认券商配置？或者您想自定义配置？”
     3. **等待用户回答**。如果用户回答“一键导入”或“同意导入”，你才调用 `POST /api/brokers/seed-defaults` 传入该市场代码，然后再调用 `GET /api/brokers/` 获取刚创建的 `broker_id`。如果用户要求“自定义”，请引导用户提供券商名称和佣金费率。
     4. 拿到 `broker_id` 后，调用 `POST /api/brokers/calculate-commission` 计算精确的手续费（commission、stamp_duty 等）。
4. **交易录入前校验**：在发起 `POST /api/trades/` 之前，必须逐项核对并向用户确认以下字段（缺一不可）：
   - `symbol`：与用户意图一致，且无多余空格
   - `market`：与标的所属市场一致（如 us/hk/cn_a 等）
   - `trade_type`：buy/sell 与用户意图一致
   - `quantity`：为正数；若用户说“清仓/全卖”，必须先查持仓再填入
   - `price`：为正数，单位与市场/货币一致
   - `fees`：在已配置券商时先用 `/api/brokers/calculate-commission` 计算；将 `total_fees` 写入 `commission`，并把明细（commission/stamp_duty/transfer_fee）写入 `notes`
   - `trade_date`：明确的时间（含时区）；若用户未指定，需询问或使用用户确认的默认时间
5. **最终确认**：在执行写入前，必须输

trade-execution/SKILL.md

---
name: trade-execution
description: 专门用于代表用户向系统中记录买入或卖出交易的助手。
user-invocable: true
---

# 交易执行助手 (Trade Execution)

专门用于代表用户向系统中记录买入或卖出交易的助手。

## 认证与基础配置
- 环境变量: `STOCK_API_KEY`
- Base URL: 从 `config.sh` 中读取 `$STOCK_BASE_URL`（默认 `https://www.mystockearning.cn`，切换域名只需改 `config.sh`）

## API 指令清单

### 记录新交易与券商配置
当用户说 "我今天以 150 美元买入了 100 股苹果" 时：
- 1) 检查市场券商：执行 `./scripts/get_brokers.sh`（需要设置 `MARKET`）
- 2) 如需导入默认券商：执行 `./scripts/seed_defaults.sh`（需要设置 `MARKET`）
- 3) 计算手续费：执行 `./scripts/calculate_commission.sh`（需要设置 `BROKER_ID`、`TRADE_TYPE`、`QUANTITY`、`PRICE`）
- 4) 记录交易：执行 `./scripts/create_trade.sh`（需要设置 `SYMBOL`、`NAME`、`MARKET`、`TRADE_TYPE`、`QUANTITY`、`PRICE`、`TRADE_DATE`；可选 `COMMISSION`、`CURRENCY`、`NOTES`）

## 严格执行规则
1. 分析用户指令。
2. **货币显示规则**：在回复任何金额（如价格、手续费、总额等）时，必须根据该股票所在的市场显示正确的货币符号或单位：
   - `cn_a` (A股): `¥` 或 `元` (人民币 CNY)
   - `hk` (港股): `HK$` 或 `港元` (港币 HKD)
   - `us` (美股): `$` 或 `美元` (美元 USD)
3. **智能补全与确认机制**：当用户想要记录交易时，你必须按照以下逻辑处理：
   - **(代码补全)**：如果没有提供完整的股票代码和市场，先调 `GET /api/positions/` 查持仓；没找到则调用搜索 API (`/api/markets/search/stocks`) 遍历 cn_a, hk, us。
   - **(清仓智能识别)**：如果用户说“清仓”、“全卖了”，且未提供数量，必须先调用 `GET /api/positions/` 获取该股票的当前持仓数量，并自动填入。
   - **(防爆仓拦截)**：如果是卖出操作且提供了数量，必须先调用 `GET /api/positions/` 检查余额。如果余额不足，直接拒绝并提示用户当前实际持有量。
   - **(市价智能获取)**：如果用户未提供**买入价格**，静默调用 `/api/markets/stocks/{symbol}/price` 获取当前市价，并作为默认建议价询问用户。
   - **(按金额反推数量)**：如果用户提供了总金额和单价但未提供数量，自动计算 `数量 = 向下取整(总金额 / 单价)` 并向用户确认。
3. **券商前置拦截与算费机制**：在确认了股票代码、数量和价格后，在发起最终交易前，必须执行以下步骤：
   - 调用 `GET /api/brokers/?market={对应的市场}`。
   - 如果返回空列表 `[]`，说明该市场无券商。你必须**拦截交易并暂停**，询问用户：“您在这个市场尚未配置券商，无法计算印花税和交易佣金。是否需要为您一键导入该市场的默认券商配置？或者您想自定义配置？”
   - **等待用户回答**。如果用户回答“一键导入”或“同意导入”，你才调用 `POST /api/brokers/seed-defaults` 传入该市场代码，然后再调用 `GET /api/brokers/` 获取刚创建的 `broker_id`。如果用户要求“自定义”，请引导用户提供券商名称和佣金费率。
   - 拿到 `broker_id` 后，调用 `POST /api/brokers/calculate-commission` 计算精确的手续费（commission、stamp_duty 等）。
4. **最终确认**：在发起最终的 `POST /api/trades/` 之前，**必须**向用户输出一段确认信息（包含代码、名称、市场、数量、价格、以及**预估的手续费/印花税总计**）。只有在用户回复确认后，才能执行。
5. **确认后执行**：执行 `curl -X POST /api/trades/` 记录交易（带上获取到的 broker_id 和费用数据）。
6. **输出结果**：根据 API 响应，向用户确认交易已成功记录，并展示总金额。

Github ReposUpdated 2d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.