Skip to main content

A fast CLI tool for real-time stock data

Project description

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

Project details


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.7.tar.gz (93.4 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.7-py3-none-any.whl (36.2 kB view details)

Uploaded Python 3

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

Hashes for agent_stock-0.2.7.tar.gz
Algorithm Hash digest
SHA256 338a8f2f916db62385d7fed170e0183e66407348674f7bf54e22f1f4c3de27fe
MD5 aafda93f20a753a63c1eb14f636d0d5f
BLAKE2b-256 e90b1ba670d0917ee30d9cff38ac797daee4916360c79e855aaa1dfb7f356546

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_stock-0.2.7.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.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

Hashes for agent_stock-0.2.7-py3-none-any.whl
Algorithm Hash digest
SHA256 d8c2ddd257f06414127aa31c10122787760b1d39f3a720ed7c9f139dd0afd7b1
MD5 799801f5dbd894dec880bfdd2cb43561
BLAKE2b-256 409f6daf59d3d179d6079e48aa904356739c8b1602e2f5c20c2f0fd2f65acc76

See more details on using hashes here.

Provenance

The following attestation bundles were made for agent_stock-0.2.7-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.

Supported by

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