Skip to main content

agent-stock

CI PyPI version Python

面向 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 --helpstock <子命令> --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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agent_stock-0.2.8.tar.gz (96.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agent_stock-0.2.8-py3-none-any.whl (36.2 kB view details)

Uploaded Python 3

File details

Details for the file agent_stock-0.2.8.tar.gz.

File metadata

  • Download URL: agent_stock-0.2.8.tar.gz
  • Upload date:
  • Size: 96.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agent_stock-0.2.8.tar.gz
Algorithm Hash digest
SHA256 fbc1cd0d4d07faec93616ee6dcfedd5f0738b281cb4473c232f42dd1c6e5f477
MD5 bd2aa4a1a855cea5393eb9f1996134ad
BLAKE2b-256 ae286395a5db87f50c5be14bf1fb620376f1a781b2ff4afe7c80e32cae210340

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_stock-0.2.8.tar.gz:

Publisher: publish.yml on AnoyiX/agent-stock

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agent_stock-0.2.8-py3-none-any.whl.

File metadata

  • Download URL: agent_stock-0.2.8-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

Hashes for agent_stock-0.2.8-py3-none-any.whl
Algorithm Hash digest
SHA256 9fe5f361c042a3660f221622a6f16823cc68393b018282a79430a3b3fa1f3286
MD5 e523381a0da4a55bfe460a4d88ef4754
BLAKE2b-256 4f2bd15560032e250fb6bad27ae0a612ab6d98b295e6112a4f9cd9ee7270546c

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_stock-0.2.8-py3-none-any.whl:

Publisher: publish.yml on AnoyiX/agent-stock

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.8 This release

2 files

0.2.7

2 files

0.2.6

2 files

0.2.5

2 files

0.2.4

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.9

2 files

0.1.8

2 files

0.1.7

2 files

0.1.6

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page