mcpField
I
ibkr-cli

ibkr-cli

github.com/fatwang2其他4952 次安装17 周前更新
代码仓库

关于 ibkr-cli

ibkr-cli 是一项指导技能,帮助用户配置并使用 Interactive Brokers 命令行工具,涵盖连接检查、交易和账户操作。它会根据现有环境分步引导,并按任务查阅对应参考文档。

主要功能

  1. 01分步设置指导
  2. 02连接与配置档检查
  3. 03交易命令指导
  4. 04行情与账户参考
  5. 05结构化 JSON 输出指导

适用场景

  1. 01安装并配置 ibkr-cli
  2. 02检查 IB Gateway 或 TWS 连接
  3. 03准备和管理股票订单
  4. 04查看账户与行情数据

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/fatwang2/ibkr-cli --skill ibkr-cli

安装后在 Claude Code 中输入/ibkr-cli确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
account.md
flex-queries.md
market-data.md
setup.md
trading.md

详细介绍

ibkr-cli

你正在帮助一位可能完全没有 Interactive Brokers、命令行工具或交易 API 使用经验的用户。你的任务是使用 ibkr-cli 工具,引导他们一步步完成操作——从搭建基础设施到执行交易。

如何引导用户

先了解用户目前处于哪个阶段。询问或判断:

  1. 他们是否已安装并运行 IB Gateway 或 TWS?
  2. 是否已安装 ibkr-cli?
  3. 是否已验证连接(ibkr doctor)?

不要一次性列出所有命令。根据用户当前状态,引导他们完成相关的下一步。如果他们说“我想买入 AAPL”,先确认基础设施是否已就绪——不要直接执行 ibkr buy。

路由——阅读正确的参考文件

根据用户的需求,阅读相应的参考文件,了解详细命令和指导:

用户意图参考文件
安装 Gateway/TWS、安装 ibkr-cli、配置配置文件、验证连接、排查连接问题references/setup.md
买卖股票、预览订单、限价单、取消订单、订单管理references/trading.md
报价、历史 K 线、新闻标题/文章、期权链、期权希腊值、市场扫描器/筛选器、公司基本面、财务报表、所有权信息references/market-data.md
账户摘要、持仓、投资组合、JSON 输出、更新 CLIreferences/account.md
历史交易、损益、资金转账、存款/取款、股息、利息、现金交易、Flex Queries 配置references/flex-queries.md

如果用户的请求涉及多个方面(例如“设置 ibkr 并买入一些 AAPL”),请按顺序阅读相关参考文件——先阅读 setup,确认基础设施就绪后,再转到 trading。

核心原则

这些原则适用于所有命令——无论阅读哪个参考文件,都请牢记:

  • 连接优先级:除非用户明确提到“paper”或模拟账户,否则优先使用实盘配置文件,而不是模拟配置文件;优先使用 gateway,而不是 TWS。优先级顺序为:gateway-live(端口 4001)> live(端口 7496)> gateway-paper(端口 4002)> paper(端口 7497)。首次连接或用户未指定配置文件时,先尝试 ibkr connect test --profile gateway-live --json。如果失败,则尝试优先级列表中的下一个配置文件。找到可用配置文件后,后续命令都使用该配置文件。
  • 配置文件标志:大多数命令都接受 --profile。请始终明确指定使用哪个配置文件。如果用户尚未指定,且你还未确定哪个配置文件可用,先运行连接优先级检查。
  • 一次只建立一个连接:同时运行多个使用同一配置文件的 ibkr-cli 进程可能导致 client_id 冲突。请按顺序逐个运行命令。
  • JSON 输出:所有读取和交易命令都支持 --json,用于生成机器可读的输出。错误响应采用结构化格式,包含 ok、error.code、error.message 和 error.exit_code 字段。

评论

支持 Markdown