A fast CLI tool for real-time stock data
Project description
agent-stock
面向 AI Agent 的股市数据命令行工具,提供市场概览、个股行情、板块涨跌、技术指标与资金流向等信息。
📦 安装
# uv tool
uv tool install agent-stock # 安装
uv tool upgrade agent-stock # 升级
# pip
python -m pip install agent-stock # 安装
python -m pip install -U agent-stock # 升级
🚀 快速开始
# 市场数据
stock index
stock search 腾讯
stock rank --count 20
# 个股数据
stock quote 000001
# 帮助与版本
stock --help
stock quote --help
stock -v
🔧 命令
可以通过 stock --help 或 stock <子命令> --help 查看帮助。
市场数据
stock index # 大盘主要指数总览(A股含申万一级行业数据)
stock search <keyword> # 股票搜索,仅限股票名称、股票代码、股票简称搜索
stock query <condition> # 条件选股
stock rank --sort <sort> --count <count> # 市场股票排序,sort 默认值 turnover
# 参数说明:
# - sort: 排序类型,可选 成交额 turnover|量比 volumeRatio|换手率 exchange|涨跌幅 priceRatio|主力净流入 netMainIn
# - count: 排序数量,默认 20,取值范围 1 - 100
# - keyword: 关键词,示例:腾讯、tengxun等
# - condition: 自然语言的条件语句,示例:"MACD金叉;KDJ金叉;非ST;非涨停;市盈率大于0;市盈率小于100;市值大于50亿;"
个股数据
stock detail <symbol> # 个股详情,包含股票实时行情、日K数据、技术指标、分时数据、资金流向、相关板块和概念、新闻等
stock quant <symbol> # 个股数据实时量化分析结果
# 参数说明:
# - symbol: A 股股票代码,如 600519、000001
🤖 技能
Skill 安装
npx skills add https://github.com/AnoyiX/agent-stock/tree/main/skills/agent-stock
Skill 清单
【个股决策】
输入示例: 帮我决策中国平安、帮我决策000001、使用量化方式帮我决策中国平安
【AI 选股】
输入示例: 帮我选股
【持仓分析】
输入示例(建议单次分析不要超过 6 只股票持仓的记录):
帮我分析持仓:
资金余额: 1000000
代码,名称,现价,成本,股数,持仓收益率,持仓占比
000001,xxxxxx,20.45,20.33,400,+4.96%,1.51%
000002,xxxxxx,20.82,21.84,1600,-2.92%,6.00%
000003,xxxxxx,3.46,3.89,39900,-1.05%,24.41%
000004,xxxxxx,26.89,25.34,1500,+2.88%,6.92%
[!TIP] Stocks AI 投资账本 可以一键复制持仓信息!
🐛 开发
# 安装依赖
uv sync
# 运行测试
uv run pytest tests/ -v
# Lint
uv run ruff check .
# 调试
uv run python -m stock quote 000001
在 IDE 中启用该技能,以 Trae 为例:
mkdir -p $(pwd)/.trae/skills/
ln -s $(pwd)/skills $(pwd)/.trae/skills
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file agent_stock-0.2.7.tar.gz.
File metadata
- Download URL: agent_stock-0.2.7.tar.gz
- Upload date:
- Size: 93.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
338a8f2f916db62385d7fed170e0183e66407348674f7bf54e22f1f4c3de27fe
|
|
| MD5 |
aafda93f20a753a63c1eb14f636d0d5f
|
|
| BLAKE2b-256 |
e90b1ba670d0917ee30d9cff38ac797daee4916360c79e855aaa1dfb7f356546
|
Provenance
The following attestation bundles were made for agent_stock-0.2.7.tar.gz:
Publisher:
publish.yml on AnoyiX/agent-stock
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agent_stock-0.2.7.tar.gz -
Subject digest:
338a8f2f916db62385d7fed170e0183e66407348674f7bf54e22f1f4c3de27fe - Sigstore transparency entry: 1368458344
- Sigstore integration time:
-
Permalink:
AnoyiX/agent-stock@709a51d71d40772e3ae1879993c111ead9acf409 -
Branch / Tag:
refs/tags/v0.2.7 - Owner: https://github.com/AnoyiX
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@709a51d71d40772e3ae1879993c111ead9acf409 -
Trigger Event:
push
-
Statement type:
File details
Details for the file agent_stock-0.2.7-py3-none-any.whl.
File metadata
- Download URL: agent_stock-0.2.7-py3-none-any.whl
- Upload date:
- Size: 36.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d8c2ddd257f06414127aa31c10122787760b1d39f3a720ed7c9f139dd0afd7b1
|
|
| MD5 |
799801f5dbd894dec880bfdd2cb43561
|
|
| BLAKE2b-256 |
409f6daf59d3d179d6079e48aa904356739c8b1602e2f5c20c2f0fd2f65acc76
|
Provenance
The following attestation bundles were made for agent_stock-0.2.7-py3-none-any.whl:
Publisher:
publish.yml on AnoyiX/agent-stock
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
agent_stock-0.2.7-py3-none-any.whl -
Subject digest:
d8c2ddd257f06414127aa31c10122787760b1d39f3a720ed7c9f139dd0afd7b1 - Sigstore transparency entry: 1368458375
- Sigstore integration time:
-
Permalink:
AnoyiX/agent-stock@709a51d71d40772e3ae1879993c111ead9acf409 -
Branch / Tag:
refs/tags/v0.2.7 - Owner: https://github.com/AnoyiX
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@709a51d71d40772e3ae1879993c111ead9acf409 -
Trigger Event:
push
-
Statement type: