← Back to Skills Marketplace
qingkongzhiqian

Groundapi Stock Screener

by qingkongzhiqian · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ Security Clean
194
Downloads
1
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install groundapi-stock-screener
Description
Screen A-share stocks by PE, PB, market cap, dividend yield, industry, concept — with preset filters, macro context (gold/forex), and deep-dive into results...
README (SKILL.md)

A 股选股助手

当用户要求选股、筛选、或类似以下表达时自动触发:

  • "帮我找几只低估值的股票"、"高分红的有哪些"
  • "PE 低于 10 的银行股"
  • "市值 100 亿以下的科技股"
  • "AI 概念里哪些股票不错"

前置条件

{
  "mcpServers": {
    "groundapi": {
      "url": "https://mcp.groundapi.net/mcp",
      "headers": {
        "X-API-Key": "sk_gapi_xxxxx"
      }
    }
  }
}

执行流程

Step 1 — 理解用户需求,映射为筛选参数

用户说 映射为
"低估值" pe_max=15
"高分红" min_dividend_yield=3, sort_by="dividend_yield"
"银行股" industry="银行"
"AI概念" concept="AI"
"小盘股" max_market_cap=10000000000
"大盘蓝筹" min_market_cap=50000000000, pe_max=20

也可以用预置组合快速筛选:

  • filter_preset="low_pe_high_div" → PE\x3C15 且 股息率>3%
  • filter_preset="small_cap_growth" → 市值\x3C100亿
  • filter_preset="large_cap_stable" → 市值>500亿 且 PE\x3C20

Step 2 — 执行筛选

finance_screen(industry="银行", pe_max=10, sort_by="pe", order="asc", limit=20)

Step 3 — 宏观环境参考

并行获取宏观数据,为选股提供大环境背景:

  • life_calendar() → 确认是否交易日
  • finance_gold_price() → 金价走势(避险情绪参考)
  • finance_exchange_rate(from_currency="USD", to_currency="CNY") → 汇率(外贸/外资敏感行业参考)

Step 4 — 对优选结果深度挖掘

从筛选结果中取 Top 3-5 只,调用 summary 获取多维度数据: finance_stock(symbol="601398,601939,600036", aspects="overview")

或逐个深度分析: finance_stock(symbol="601398", aspects="summary")

Step 5 — 输出选股报告

## 选股结果 — {筛选条件描述}

### 宏观环境
- 日期:{YYYY-MM-DD}({交易日/非交易日})
- 黄金:¥XXX/克 | 美元兑人民币:X.XXXX

### 筛选条件
- 行业:银行
- PE 上限:10
- 排序:PE 从低到高

### 结果(共XX只)
| 排名 | 代码 | 名称 | PE | PB | 股息率 | 市值(亿) | 今日涨跌 |
|------|------|------|-----|-----|--------|---------|---------|
| 1 | 601398 | 工商银行 | 5.2 | 0.5 | 6.1% | 18000 | +0.3% |
| 2 | ... | ... | ... | ... | ... | ... | ... |

### Top 3 快速概览

**1. 工商银行(601398)**
- 主力资金:近5日净流入XX亿
- 技术面:均线多头排列,MACD金叉
- 股东:户数连续3期减少(筹码集中)

**2. ...**

以上数据基于公开信息,不构成投资建议。

注意事项

  • finance_screen 依赖数据库快照数据,非实时交易数据
  • 筛选条件可自由组合,所有参数均可选
  • PE 为负的股票默认被过滤(亏损企业)
  • 输出语言跟随用户
Usage Guidance
This skill appears internally consistent, but before installing: confirm that the GROUNDAPI_KEY you supply is from the official GroundAPI service and has only the minimal permissions needed; review GroundAPI's privacy and data‑handling policies; avoid reusing a high‑privilege key elsewhere; monitor usage/rate limits and rotate or revoke the key if you see unexpected calls. Remember outputs are informational and not investment advice. If you need stronger assurance, ask the skill author for documentation or an auditable request/response example showing the exact MCP endpoints called and the minimum scope required for the API key.
Capability Analysis
Type: OpenClaw Skill Name: groundapi-stock-screener Version: 1.1.0 The skill is a stock screening tool for the Chinese A-share market that utilizes the GroundAPI MCP service (mcp.groundapi.net). It provides structured instructions for an AI agent to map user queries to financial parameters, execute data retrieval tools like finance_screen and finance_stock, and generate a formatted report. No indicators of data exfiltration, malicious execution, or prompt injection were found.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description (A‑share stock screener) align with the declared requirement: a single GROUNDAPI_KEY used to call GroundAPI MCP endpoints to run screening and retrieval functions.
Instruction Scope
SKILL.md contains only domain‑relevant instructions: mapping user requests to screening parameters and calling finance_screen / finance_stock / macro helper functions. It does not instruct reading other files, system credentials, or sending data to unrelated endpoints.
Install Mechanism
No install spec or code files are present (instruction‑only). Nothing is downloaded or written to disk by the skill itself.
Credentials
Only one environment variable is required (GROUNDAPI_KEY), which is appropriate for an API client. There are no additional secrets or unrelated credentials requested.
Persistence & Privilege
The skill is not always‑on (always: false). It is user‑invocable and can be autonomously invoked by the agent when eligible (platform default) — this is expected for skills but means it may call the GroundAPI endpoint whenever triggered.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install groundapi-stock-screener
  3. After installation, invoke the skill by name or use /groundapi-stock-screener
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.0
v1.1.0: Add gold/forex macro context, calendar trading day check, update MCP endpoint
v1.0.0
Initial release — smart natural language A-share stock screener. - Accepts natural language investment preferences and translates them into stock screening filters. - Automatically triggers on common screening requests (e.g., "低估值消费股", "高分红银行股", "PE低于20"). - Returns structured and ranked stock candidates, with detailed fundamentals for top 5 results. - Supports conversational refinement (e.g., "PE再低一点", "换个行业看看"). - Requires GroundAPI MCP Server access and GROUNDAPI_KEY.
Metadata
Slug groundapi-stock-screener
Version 1.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Groundapi Stock Screener?

Screen A-share stocks by PE, PB, market cap, dividend yield, industry, concept — with preset filters, macro context (gold/forex), and deep-dive into results... It is an AI Agent Skill for Claude Code / OpenClaw, with 194 downloads so far.

How do I install Groundapi Stock Screener?

Run "/install groundapi-stock-screener" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Groundapi Stock Screener free?

Yes, Groundapi Stock Screener is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Groundapi Stock Screener support?

Groundapi Stock Screener is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Groundapi Stock Screener?

It is built and maintained by qingkongzhiqian (@qingkongzhiqian); the current version is v1.1.0.

💬 Comments