search_stock搜索股票公开读限速日配额
返回候选列表:带市场前缀的
code 与名称q*string关键词:股票名称 / 代码 / 拼音首字母https://chanshu.top/api/mcpMcp-Session-Id;GET / DELETE 回 405initialize 的 instructions;工具清单按连接开放的工具组过滤(见工具分组,默认全部);没有写权限的写工具照样列出,调用时回拒绝read基础全部读工具debt:write记录负债debt_*watchlist:write管理自选watchlist_add / watchlist_removealert:write管理股价提醒alert_set / alert_removeexpense:write记录消费expense_add / expense_update / expense_delete / expense_restore / expense_import_commit / expense_import_revoke / expense_recurring_set / expense_recurring_pausefeedback:write提交反馈feedback_create / feedback_reply / feedback_reply_retract / feedback_close / feedback_mark_readportfolio:write管理我的持仓portfolio_record_add / portfolio_record_update / portfolio_record_delete / portfolio_record_restore / portfolio_settings_set / portfolio_cash_sethealth:write设定财务健康目标finance_health_setanalysis:write记录分析笔记analysis_topic_set / analysis_memory_set / analysis_report_add / analysis_report_delete / analysis_report_restorescope_missing):宿主里对 chanshu 重新登录(Claude Code 在 /mcp 里重新认证),或在账号设置断开,下次使用自动重新授权unattended=true 表示没人在场:消费写落待确认,持仓与财务健康目标写回 needs_confirmation,反馈只能提交与追加,分析笔记照常生效(定时写入正是它的用法);确认只能本人在网页 / App 里做search_stock / stock_quote / stock_tickers / stock_kline / stock_brief / market_breadth / stock_news / fund_detail / my_watchlist / my_positions / portfolio_pnl / portfolio_week / finance_overviewtools/list;硬调回 isError「该工具未在此连接开放」;用到它的 prompt 也不列market行情 · 8search_stock / stock_quote / stock_tickers / stock_trends / stock_kline / stock_brief / market_breadth / stock_margincompany公司资料 · 5stock_profile / stock_financials / stock_shareholders / stock_notices / stock_newsfutures期货 · 13futures_search / futures_list / futures_quote / futures_tickers / futures_trends / futures_kline / my_futures_watchlist / futures_watchlist_add / futures_watchlist_remove / my_futures_positions / futures_record_list / futures_record_add / futures_record_deletefund基金 · 5search_fund / fund_detail / fund_holding_changes / funds_holding_stock / fund_stock_analysisportfolio我的持仓 · 10my_positions / portfolio_week / portfolio_record_list / portfolio_pnl / portfolio_record_add / portfolio_record_update / portfolio_record_delete / portfolio_record_restore / portfolio_settings_set / portfolio_cash_setwatch自选与提醒 · 6my_watchlist / watchlist_add / watchlist_remove / alert_list / alert_set / alert_removeoverview财务全景 · 1finance_overviewhealth财务健康 · 2finance_health / finance_health_setdebt负债 · 8my_loans / debt_loan_create / debt_loan_update / debt_loan_mark / debt_prepay_add / debt_prepay_revoke / debt_loan_delete / debt_loan_restoreexpense消费记账 · 17expense_list / expense_get / expense_summary / expense_categories / expense_quota / expense_import_list / expense_recurring_list / expense_draft / expense_import_preview / expense_add / expense_update / expense_delete / expense_restore / expense_import_commit / expense_import_revoke / expense_recurring_set / expense_recurring_pausefeedback意见反馈 · 8feedback_list / feedback_get / feedback_image / feedback_create / feedback_reply / feedback_reply_retract / feedback_close / feedback_mark_readanalysis分析笔记 · 8analysis_state_get / analysis_report_list / analysis_report_get / analysis_topic_set / analysis_memory_set / analysis_report_add / analysis_report_delete / analysis_report_restore{
"mcpServers": {
"chanshu": {
"type": "http",
"url": "https://chanshu.top/api/mcp"
}
}
}~/.workbuddy/mcp.json),保存后点「连接」在浏览器登录授权- id: mcp-chanshu
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: chanshu
transport: stdio
command: npx
args: ['-y', 'mcp-remote', 'https://chanshu.top/api/mcp']~/.dsh/profiles/desktop/cordis.patch.yml 末尾;它的 MCP 客户端不做 OAuth,经 mcp-remote 桥接登录——先在终端跑一次 npx -y mcp-remote https://chanshu.top/api/mcp 授权(令牌缓存在 ~/.mcp-auth),再重启。Windows 上 npx 起不来就改 command: cmd、args: ['/c', 'npx', '-y', 'mcp-remote', 'https://chanshu.top/api/mcp']claude mcp add --transport http -s user chanshu https://chanshu.top/api/mcp-s user 让所有目录都能用,不带只加到当前目录。和上面的连接器二选一,两个都加会出现两份 chanshu;加完在会话里输入 /mcp,选 chanshu 登录授权[mcp_servers.chanshu]
url = "https://chanshu.top/api/mcp"{
"mcpServers": {
"chanshu": {
"url": "https://chanshu.top/api/mcp"
}
}
}search_stock按名称 / 代码 / 拼音首字母搜 A 股、港股、美股公开读限速日配额
stock_quote一只股票或指数的当前快照公开读限速日配额
stock_tickers批量精简行情,1–50 只公开读限速日配额
stock_kline历史 K 线,前复权公开读限速日配额
stock_trends当日逐分钟分时公开读限速日配额
market_breadth沪 / 深 / 北三市涨跌家数公开读限速日配额
stock_brief个股速览,一次调用公开读限速
stock_financials财报核心指标公开读限速日配额
stock_profile公司简况(F10)与估值、股本公开读限速日配额
stock_shareholders十大股东 / 十大流通股东与较上期变动公开读限速日配额
stock_margin融资融券逐日明细:融资余额、净买入、融券余额公开读限速日配额
stock_notices最新公司公告:标题、类型与原文链接公开读限速日配额
stock_news最新资讯:标题、媒体、导语摘要与链接公开读限速日配额
search_stock搜索股票公开读限速日配额code 与名称q*string关键词:股票名称 / 代码 / 拼音首字母stock_quote个股快照公开读限速日配额code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXstock_tickers批量行情公开读限速日配额errorscodes*array股票代码列表(1..50 个),格式同 stock_quote 的 codestock_kline历史 K 线公开读限速日配额end 往前翻,每页计一次限速与日配额code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXperiodday / week / monthK 线周期:day / week / month,默认 daylmt120 / 250这一页的根数:120(默认,约半年日线)或 250(约一年日线)endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一根的前一天;空 = 最新一页stock_trends当日分时公开读限速日配额code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXmarket_breadth市场涨跌家数公开读限速日配额asOf 为取数时刻stale: true,从没成功过才报错marketsarray市场列表,取值 sh / sz / bj;缺省为三市stock_brief个股速览公开读限速ah(对面那只的行情与 A/H 比价)code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXstock_financials个股财报核心指标公开读限速日配额annual 年报(≤8 年)、quarterly 单季(≤12 期)、latest 最新一份累计报告;银行 / 保险 / 券商另给 extrascode*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700stock_profile个股简况公开读限速日配额holderscode*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700stock_shareholders十大股东公开读限速日配额top(占总股本 %)与十大流通股东 free(占流通股 %,带股东性质):名次、持股数、较上期增减股数与比例、状态(新进 / 增持 / 减持 / 不变),上期在前十、本期退出的 exited;可选报告期 periodsstock_profilecode*stringA 股代码,带小写市场前缀:sh600519 / sz000001(港股、美股没有这项数据)periodstring报告期 YYYY-MM-DD(季末日,须为返回的 periods 之一);省略 = 最新一期stock_margin个股融资融券公开读限速日配额rows(最新在前):融资余额 / 买入额 / 偿还额 / 净买入、融券余额 / 余量 / 卖出量 / 偿还量、融资融券余额、融资余额占流通市值、收盘价与涨跌幅;数据日期 asOf、是否两融标的 marginable、更早还有没有 moremarginable: false、rows 为空;数据是上一交易日的,次日上午更新;金额元、量股、比率 %;只给原始数据,不做判断;缓存 1 小时code*stringA 股(沪 / 深 / 北)个股或 ETF 代码,带小写市场前缀:sz300308 / sh600519 / bj920438 / sh510300(港股、美股、指数没有这项数据)lmt20 / 60 / 250这一页的交易日数:20 / 60(默认,约 3 个月)/ 250(约一年)endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一行的前一天;空 = 最新一页stock_notices个股公告公开读限速日配额date(盘后发布记次日)、发布时刻 time、标题、类型 type(东财栏目)、原文 url 与 pdfcode*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700limitinteger最多返回多少条,1..50,默认 20stock_news个股资讯公开读限速日配额time、标题、媒体 media、导语摘要 summary(文章开头约 120 字)、原文 url;同标题转载只留一条code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXlimitinteger最多返回多少条,1..20,默认 10futures_search按品种名 / 代码 / 拼音首字母搜国内期货合约公开读限速日配额
futures_list全部主力 / 夜盘主力 / 全部合约,按板块与交易所筛公开读限速日配额
futures_quote一个合约的快照:昨结、结算、持仓量与日增仓公开读限速日配额
futures_tickers批量精简行情,1–50 个公开读限速日配额
futures_trends当个交易日逐分钟分时(含夜盘)公开读限速日配额
futures_kline日 K,原始价,带结算价与持仓量公开读限速日配额
my_futures_watchlist我的期货自选,附最新价本人读限速
futures_watchlist_add加入期货自选watchlist:write写限速
futures_watchlist_remove移出期货自选watchlist:write写限速
my_futures_positions我的期货持仓:多空、均价、浮盈、保证金本人读限速
futures_record_list期货开平仓记录本人
futures_record_add记一笔开多 / 开空 / 平多 / 平空portfolio:write写限速
futures_record_delete删一笔记错的记录portfolio:write写限速
futures_search搜索期货合约公开读限速日配额q*string关键词:品种名(螺纹钢 / 沪深300)、合约代码前缀(rb / rb27)或拼音首字母(lwg),可接年月(lwg2705)futures_list期货行情列表公开读限速日配额sectors / exchanges 两组筛选计数与 asOfmainCode(当前对应的具体合约);一次拿全部主力,不必逐只 futures_quotesessionmain / night / all时段口径:main = 全部主力(每个品种一只主力连续,缺省)/ night = 夜盘主力(有夜盘的品种)/ all = 全部具体合约sectorstring板块:金融 / 贵金属 / 有色 / 黑色 / 能源 / 化工 / 农产品 / 其他;空 = 不筛exchangestring交易所:shfe 上期所 / ine 上期能源 / dce 大商所 / czce 郑商所 / gfex 广期所 / cffex 中金所;空 = 不筛productstring品种代码(rb / sa / if…):给了就列该品种的主力连续与全部在市合约,忽略 sessionfutures_quote期货快照公开读限速日配额marketOpen / sessioncode*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)futures_tickers期货批量行情公开读限速日配额errorscodes*array期货合约代码列表(1..50 个),格式同 futures_quote 的 codefutures_trends期货分时公开读限速日配额sessions 为当日交易时段code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)futures_kline期货日 K公开读限速日配额more 表示更早还有end 往前翻,每页计一次限速与日配额code*string期货合约代码(格式同 futures_quote)lmt120 / 250这一页的根数:120(默认,约半年日线)或 250(约一年日线)endstring截止日 YYYY-MM-DD(含当日),往前翻页用:取上一页最早一根的前一天;空 = 最新一页my_futures_watchlist我的期货自选本人读限速priceMissing;urlfutures_watchlist_add加入期货自选watchlist:write写限速code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)futures_watchlist_remove移出期货自选watchlist:write写限速code*string期货合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0 / if0)my_futures_positions我的期货持仓本人读限速totals.equity = 开仓保证金 + 浮动盈亏include_closedboolean是否另列已平完的合约方向(只有累计平仓盈亏有意义),默认 falsefutures_record_list期货开平仓记录本人realizedcodestring只看某个合约(rb2701;郑商所 SA701 也认);空 = 全部futures_record_add记一笔期货开平仓portfolio:write写限速code*string具体合约代码:品种 + 四位年月(rb2701 / sa2701 / if2612;郑商所 SA701 也认);主力连续 rb0 不能记,先 futures_quote 看 mainCodeside*string方向:open_long 开多 / open_short 开空 / close_long 平多 / close_short 平空date*string成交日期 YYYY-MM-DD(东八区),不晚于今天timestring成交时刻 HH:MM(可选)price*number成交价lots*integer手数,正整数multnumber合约乘数(每手多少报价单位,如螺纹 10、沪深300 300);不给按品种表预填margin_ratenumber保证金率 %(0–100);不给预填(国债 3,其余 12),以自己账户为准feenumber手续费(元),≥ 0notestring备注,≤ 40 字futures_record_delete删一笔期货记录portfolio:write写限速id*string记录 id(futures_record_list 返回的 records[].id)search_fund按名称 / 代码子串搜公募基金公开
fund_detail基金基本信息与当期十大持仓公开
funds_holding_stock当期十大持仓含某只股票的基金公开
fund_holding_changes本期 vs 上期十大持仓变动公开
fund_stock_analysis站在一只 A 股上看全部基金本季 vs 上季公开读限速
search_fund搜索基金公开q*string基金名称 / 代码子串pageinteger页码,从 1 起,默认 1sizeinteger每页条数,1..50,默认 20fund_detail基金详情公开via 给目标代码)code*string基金代码(6 位数字)funds_holding_stock持有某股的基金公开code*string股票代码:600519 / sh600519 / 00700 / NVDA 均可pageinteger页码,从 1 起,默认 1sizeinteger每页条数,1..50,默认 20fund_holding_changes基金持仓变动公开hasPrev=falsefund_stock_analysiscode*string基金代码(6 位数字)periodstring本期报告期 YYYY-MM-DD(季末日);省略 = 最新期fund_stock_analysis股票的基金持仓分析公开读限速final=false 表示季报还在披露code*stringA 股代码:sh603986 / sz000001 / bj920438,或裸 6 位代码groupstring排行范围:all(全部基金,默认)/ active(只看主动权益基金);汇总两组都给periodstring报告期 YYYY-MM-DD(季末日:03-31 / 06-30 / 09-30 / 12-31);省略 = 最近一个已有基金披露的季度finance_overview财务全景:资产、负债(含融资)、净资产、日息、60 天应还本人读限速
my_positions按股汇总当前持仓本人读限速
portfolio_week本周持仓复盘本人读限速
portfolio_record_list持仓买卖记录本人读限速
portfolio_pnl盈亏日历,按日 / 月 / 年本人读限速
portfolio_record_add记一笔买入 / 卖出portfolio:write写限速
portfolio_record_update改一笔的日期 / 时间 / 价 / 量 / 费用 / 信用(标记 / 股数)/ 年化 / 备注portfolio:write写限速
portfolio_record_delete软删除一笔portfolio:write写限速
portfolio_record_restore恢复已删除的一笔portfolio:write写限速
portfolio_settings_set设默认信用年化portfolio:write写限速
portfolio_cash_set设持仓现金portfolio:write写限速
finance_overview财务全景本人读限速stockCash、股票账户净资产 stockNetAssets;有期货持仓时另给 futures:期货权益 = 开仓保证金 + 浮动盈亏,计入资产,名义价值只看敞口)、负债(消费借款在借余额 + 券商融资本金与已计利息 + 股票账户现金透支,融资单列但计入总负债)、净资产(= 股票账户净资产 + 期货权益 − 借款余额,融资与现金各只算一次)、dailyInterest 每天新增利息、upcoming 未来 60 天应还(按到期日归并,逾期未还的排最前)、有融资时给 estMaintenanceRatioPct;url 为全景页my_positions 同一算法,以券商为准;整次只计一次限速my_positions我的持仓本人读限速weight;合计(totalAssets = 市值 + 现金);持仓现金 cash(设过才有);股票账户五个数 totals:marketValue 持仓市值 / cash 可用资产 / totalAssets 总资产 / liabilities 负债(融资本息 + 现金透支)/ netAssets 净资产;有融资时 maintenance 维持担保比例估算;urlasOf 为行情所属交易日;持仓由买卖记录实时推导,与 portfolio_record_list 同源,两次调用之间在网页改过记录才会前后不一致include_closedboolean是否另列已清仓的股票(只有累计已实现盈亏有意义),默认 falseportfolio_week本周持仓复盘本人读限速weekly_position_review 同一套算法portfolio_record_list持仓记录本人读限速total 为总条数,有 nextCursor 就带回取下一页;每条带所见 version,卖出带这笔已实现 realizedmy_positions 就是由这些记录实时推导的,两边同源、无缓存;整份导出在持仓页点「导出」codestring只看某只股票,带小写市场前缀:sh600519 / sz000001 / hk00700;空 = 全部fromstring区间起点 YYYY-MM-DD(含,按成交日期);空 = 不限statusactive / deleted / all状态:active(生效,默认)/ deleted(已删除)/ alltostring区间终点 YYYY-MM-DD(含);空 = 不限limitinteger这一页最多多少条,1..500,默认 200cursorstring翻页游标:上一页结果的 nextCursor;空 = 第一页portfolio_pnl盈亏日历本人读限速pnl、时间加权收益率 rate、已实现、卖出笔数;区间合计;取不到历史收盘价的列在 missingfromstring区间起点 YYYY-MM-DD(含);from / to 都不给 = 本月(按日)/ 今年(按月)/ 最早一笔记录那年到今年(按年)groupday / month / year分组:day(按日,默认,区间 ≤ 366 天)/ month(按月,区间 ≤ 120 个月)/ year(按年,区间 ≤ 10 年)tostring区间终点 YYYY-MM-DD(含)portfolio_record_add记一笔持仓买卖portfolio:write写限速summary;卖出附这笔已实现code*string代码,带小写市场前缀:股票 sh600519 / sz000001 / hk00700(不确定先 search_stock);场外基金 of + 6 位基金代码(of025208,不确定先 search_fund)——基金的 price 填确认净值、qty 填份额、fee 填申购 / 赎回费,不能记信用date*string成交日期 YYYY-MM-DD(东八区),1990-12-19 至今天price*number成交价,每股,A 股元、港股港元,> 0qty*number股数,> 0side*buy / sell方向:buy(买入)/ sell(卖出)feenumber这笔的费用合计(佣金 + 印花税 + 过户费),≥ 0,默认 0idempotency_keystring幂等键(按人保留 30 天):重试同一笔请带同一个键,命中返回首次结果且不再写marginboolean信用标记:买入 true = 整笔融资买入(给了 margin_qty 就以它为准);卖出 true = 信用卖出(先消耗信用批次);默认 false(普通)margin_qtynumber买入里融资买的股数(0 < margin_qty ≤ qty):一笔可同时含普通股与信用股,qty − margin_qty 是普通股,年化只对这部分计息;不给而 margin=true = 整笔信用;卖出忽略notestring备注,≤ 40 字ratenumber年化 %(仅买入的信用股数有意义,0–36);信用买入不给则取默认信用年化timestring成交时间 HH:MM(东八区,可选);给了网页分时图上才会标出这笔unattendedboolean无人值守(Agent 自主、没人在场)= true:一律 needs_confirmation 不记;默认 false = 代人portfolio_record_update改一笔持仓记录portfolio:write写限速id*string记录 id(portfolio_record_list 返回的 records[].id)datestring改成交日期 YYYY-MM-DD;不传不改feenumber改费用;不传不改marginboolean改信用标记;不传不改(买入:true = 整笔信用、false = 清掉信用股数,给了 margin_qty 以它为准;买入改成信用且不给 rate 时取默认信用年化)margin_qtynumber改买入里的信用股数(0 ≤ margin_qty ≤ qty,0 = 整笔普通);不传不改;卖出忽略notestring改备注;不传不改(传空串 = 清空)pricenumber改成交价;不传不改qtynumber改股数;不传不改(原来整笔信用的买入只改 qty,信用股数跟着变)ratenumber改年化 %(0–36);不传不改timestring改成交时间 HH:MM;不传不改(传空串 = 清掉时间)unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人versioninteger所见版本(portfolio_record_list 返回的 version);过期 → conflict;0 / 不传 = 不比对portfolio_record_delete删除一笔持仓记录(软删除)portfolio:write写限速oversoldid*string记录 id(portfolio_record_list 返回的 records[].id)unattendedboolean无人值守 = true:一律 needs_confirmation 不删;默认 false = 代人versioninteger所见版本;过期 → conflict;0 / 不传 = 不比对portfolio_record_restore恢复已删除的持仓记录portfolio:write写限速id*string已删除记录的 id(portfolio_record_list status=deleted 返回的 records[].id)unattendedboolean无人值守 = true:一律 needs_confirmation 不恢复;默认 false = 代人portfolio_settings_set设默认信用年化portfolio:write写限速margin_rate*number默认信用年化 %(0–36,7.2 = 年化 7.2%);只影响之后新记的信用买入unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人portfolio_cash_set设持仓现金portfolio:write写限速setnumber设为现金余额(元,≥ 0);与 delta 二选一deltanumber转入为正、转出为负(不为 0);要先设过余额;与 set 二选一notestring备注,≤ 40 字unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人finance_health财务健康对照本人读限速current 现状、target 目标、gap 差额(现状 − 目标)、unit、bound(range / max / min)、beyond(差额超出用户设的阈值);资产比例每类一行 rows,集中度前五项 items;算不出时 missing 说缺什么;没设过目标时 templates 给示例配比与出处;url 为健康页finance_overview;基金按基金类型归类,期货按品种(股指 → 股票、国债 → 债券、其余 → 大宗商品)gap 只是差额,不是操作建议;系统不选标的、不给买卖方向、不预测、不评分finance_health_set设定财务健康目标health:write写限速version、changed(值没变不写)version 比对,过期回 conflicttemplatestring示例配比 key(classic_60_30_10:股票 60 / 债券 30 / 大宗商品 10,公开读物的经典配比示例);填进资产比例目标,仍是用户自己的目标allocobject资产比例:on、targets(stock / bond / commodity / cash / other 各自 %)、threshold(百分点)、cleardebt · concentration · repayobject负债占资产 / 单一持仓占资产 / 月还款占收入:on、target(上限 %)、threshold;集中度另有 penetrate(基金按十大持仓穿透)interestobject利息成本:unit pct(年化利息占资产 %)/ cny(元 / 月)、target、thresholdemergencyobject应急金:现金 ÷ 近 3 个月月均支出,target 为下限月数income · cash · bond · otherobject手填数(元):value / clear;other 可带 note。不是账本,只存一个数与更新时间notifyOn · notifyInbox · notifyPushboolean偏离提醒(默认关):每周一收盘后对照一次,只发新超出的维度versioninteger所见版本(config.version);0 = 不比对unattendedboolean无人值守 = true:一律 needs_confirmation 不改my_watchlist自选股本人读限速
watchlist_add自选加一只watchlist:write写限速
watchlist_remove自选删一只watchlist:write写限速
alert_list全部股价提醒,含已触发本人
alert_set设涨到 / 跌到目标价提醒alert:write写限速
alert_remove删一只股票的提醒alert:write写限速
my_watchlist我的自选本人读限速stock_quote);urlwatchlist_add加入自选watchlist:write写限速code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA / us.IXIC;裸代码(600519 / 00700)会按 search_stock 同源查找补前缀namestring股票名(可选);缺省按 search_stock 同源查找补上watchlist_remove移出自选watchlist:write写限速code*string股票代码,带市场前缀:sh600519 / sz000001 / hk00700 / usNVDA;美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOXalert_list我的股价提醒本人alert_set设股价提醒alert:write写限速code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700price*number目标价,单位元(港股港元),须 > 0 且不等于现价directionup / down方向:up = 涨到目标价提醒(目标价须高于现价)/ down = 跌到目标价提醒(须低于现价);缺省按现价自动推alert_remove撤销股价提醒alert:write写限速code*string股票代码,带小写市场前缀:sh600519 / sz000001 / hk00700my_loans借款摘要,按需带还款计划本人
debt_loan_create新增一笔借款debt:write写限速
debt_loan_update改一笔的条款(只传要改的字段)debt:write写限速
debt_loan_mark把第 k 期标为已还 / 未还debt:write写限速
debt_prepay_add记一笔已发生的提前还款debt:write写限速
debt_prepay_revoke撤销一条录错的提前还款debt:write写限速
debt_loan_delete软删除一笔借款debt:write写限速
debt_loan_restore恢复已删除的借款debt:write写限速
my_loans我的借款本人id 或 includeRows 时改回完整记录与逐期计划;urlbasis,360 或 365;整月按月平摊:年化 / 1200);精简摘要带 rateUnit / basis / version(改条款用);默认不列已结清(settledHidden 为没列的笔数)idstring只看这一笔(借款 id);给了即带逐期计划,不受 includeSettled 限制includeDeletedboolean是否包含已软删除的借款,默认 falseincludeRowsboolean是否带逐期还款计划与完整记录(rows / marks / prepays 等),默认 false = 每笔只给精简摘要;要标记某期(debt_loan_mark 的 k)或看逐期明细时才开,最好配合 id 只取一笔includeSettledboolean是否包含已结清的借款,默认 false(只列未结清的;settledHidden 给出没列的笔数)debt_loan_create新增借款debt:write写限速versionbasis 不传按用户给这个来源配的默认带出(没配过用 365);unattended=true 一律 needs_confirmation 不写basis360 / 365计息基数:年化与日息互换时一年按多少天。App 展示的年化按人行 2021 年第 3 号公告一律是日息 × 365,照着抄的年化配 365;合同实际按 360 计息的来源才配 360firstDue*string首次还款日,格式 YYYY-MM-DD,须晚于 start;之后每月同日(当月无此日取月末)method*annuity / linear / bullet还款方式:annuity(等额本息)/ linear(等额本金)/ bullet(先息后本)periods*integer期数(按月),1..600principal*number本金,单位元,须 > 0rate*number利率数值,单位是百分比但不带 % 号:rateUnit=year 时为年化 %(7.2 = 年化 7.2%);rateUnit=day 时为日息 %(0.02 = 日息万分之二)source*string借款来源(机构 / 平台名,如 微粒贷、招行信用卡分期),必填,≤24 字start*string放款 / 起息日,格式 YYYY-MM-DDgraceinteger先息期数,仅 bullet 有意义:前 grace 期只还息,其后等额还本;0..periods-1,缺省 = periods-1(到期一次还本)interestModedaily / monthly计息方式:daily(按实际天数,默认)每期利息 = 余额 × 日利率 × 本期实际天数;monthly(整月按月平摊)整一个月的期按 余额 × 年化 / 1200 收息、不看 28 还是 31 天,不足月的首期与提前还款切出的半截仍按天productstring产品(可选,同一来源下的哪个产品,如 京东白条、京东金条),≤40 字;是名称的一部分,列表显示为「来源 · 产品」rateUnityear / day利率单位:year(年化,默认)/ day(日息);年化换日息 = 年化 / 计息基数 basisremarkstring备注(可选,如 优化单),≤100 字;不进名称,只在借款详情里展示unattendedboolean无人值守(Agent 自主、没人在场)= true:一律 needs_confirmation 不记;默认 false = 代人debt_loan_update修改借款条款debt:write写限速version 比对,这笔刚被别处改过回 conflict 不写。年化录入的借款改 basis 会重算利息,日息录入的只改展示的年化id*string借款 id(my_loans 返回的 loans[].id)versioninteger所见版本(my_loans 返回的 version);过期 → 冲突不写;0 / 不传 = 不比对sourcestring改来源(≤24 字);不传不改productstring改产品(≤40 字,传空串 = 清空);不传不改remarkstring改备注(≤100 字,传空串 = 清空);不传不改principalnumber改本金(元,> 0);不传不改ratenumber改利率数值(百分比数字,含义看 rateUnit);不传不改rateUnityear / day改利率单位;不传不改(只改单位不改数值会让利率变意思,两者一起给)basis360 / 365改计息基数;不传不改startstring改起息日 YYYY-MM-DD;不传不改firstDuestring改首次还款日 YYYY-MM-DD(须晚于起息日);不传不改periodsinteger改期数 1..600;不传不改methodannuity / linear / bullet改还款方式;不传不改graceinteger改先息期数(仅 bullet);不传不改——原来是经典的到期一次还本就跟着新期数走interestModedaily / monthly改计息方式;不传不改unattendedboolean无人值守 = true:一律 needs_confirmation 不改;默认 false = 代人debt_loan_mark标记某期已还 / 未还debt:write写限速paid = 清掉手动标记,回到按日期判断id*string借款 id(my_loans 返回的 loans[].id)k*integer期号,1..期数(my_loans 带 id 或 includeRows=true 时计划行 rows 里的 k)paidbooleantrue = 标为已还;false = 标为未还;省略或 null = 清掉手动标记,回到按日期判断(到期日已过即视为已还)debt_prepay_add记一笔提前还款debt:write写限速debt_prepay_revoke 撤销;unattended=true 一律 needs_confirmation 不写amount*number提前还款金额,单位元,> 0 且不超过该日在借余额;等于余额即结清date*string提前还款日期,格式 YYYY-MM-DD:不晚于今天,且在 [起息日, 末次还款日) 之内id*string借款 id(my_loans 返回的 loans[].id)unattendedboolean无人值守 = true:一律 needs_confirmation 不记;默认 false = 代人debt_prepay_revoke撤销一条提前还款debt:write写限速debt_prepay_add 录回(id 会变);unattended=true 一律 needs_confirmation 不写id*string借款 id(my_loans 返回的 loans[].id)prepayId*string要撤销的那条提前还款记录 id(my_loans 带 id 时 prepays[].id)unattendedboolean无人值守 = true:一律 needs_confirmation 不撤;默认 false = 代人debt_loan_delete删除借款(软删除)debt:write写限速id*string借款 id(my_loans 返回的 loans[].id)debt_loan_restore恢复已删除的借款debt:write写限速my_loans(includeDeleted=true) 查id*string借款 id(my_loans 返回的 loans[].id)expense_list某月或某区间的记录,按日分组本人读限速
expense_get一笔的完整内容本人读限速
expense_summary区间汇总本人读限速
expense_categories分类清单本人
expense_quota当日识别配额本人读限速
expense_import_list账单导入批次本人读限速
expense_recurring_list周期规则(固定开销)本人读限速
expense_draft图片或文本识别成草稿OAuth读限速
expense_import_preview解析支付宝 CSV / 微信 XLSXOAuth读限速
expense_add记一笔支出或退款expense:write写限速
expense_update改一笔的字段expense:write写限速
expense_delete软删除一笔,含拒绝待确认expense:write写限速
expense_restore恢复已删除的记录expense:write写限速
expense_import_commit按预览整批落库expense:write写限速
expense_import_revoke整批撤销一次导入expense:write写限速
expense_recurring_set登记或修改一条周期规则expense:write写限速
expense_recurring_pause暂停 / 恢复一条规则expense:write写限速
expense_list消费记录列表本人读限速version、可否自主处理;meta.total 只计生效categorystring按分类 code 筛(见 expense_categories),空 = 不筛fromstring区间起点 YYYY-MM-DD(含),东八区交易日limitinteger最多返回多少条,缺省取服务端默认上限monthstring月份 YYYY-MM,取整月;与 from / to 互斥(都不给 = 本月)sourcestring按来源筛:manual / photo / text / import / mcp / rule,空 = 不筛statusactive / pending / deleted / all状态:active(生效,默认)/ pending(待确认)/ deleted(已删除)/ alltostring区间终点 YYYY-MM-DD(含)expense_get取一笔消费记录本人读限速version、来源 / 行为者、导入批次 batchId 或规则 ruleIdid*string记录 id(expense_list 返回的 rows[].id)expense_summary消费汇总本人读限速fixed(固定开销待入账)fixed.total 不计入 totalfromstring区间起点 YYYY-MM-DD(含);from / to 都不给 = 本月groupmonth / category / month_category分组:month(按月,默认)/ category(按分类)/ month_category(月×分类)tostring区间终点 YYYY-MM-DD(含)expense_categories消费分类清单本人expense_quota识别配额本人读限速expense_import_list导入批次列表本人读限速expense_recurring_list周期规则列表本人读限速manual / auto / paused)、下次触发日、最近生成的记录、连续被删期数expense_draft识别为草稿OAuth读限速similarimage_base64string图片内容 base64(JPEG / PNG / WebP;大小上限由服务端配置,默认 1MB,超限回 payload_too_large 附 limit_bytes;可带 data:image/...;base64, 前缀);与 text 二选一,给了图片走图片模式mimestring图片类型提示(image/jpeg / image/png / image/webp);服务端以内容嗅探为准,可不填textstring要识别的文本:支付通知、银行短信、分享账单等原文;金额与时间都抓到即不调模型、不计配额expense_import_preview账单导入预览OAuth读限速token(30 分钟)、逐行标记 add / skip_hard / merge_similar、统计file_base64*string账单文件内容 base64(支付宝交易记录 CSV / 微信支付账单 XLSX;大小上限由服务端配置,默认 2MB,超限回 payload_too_large 附 limit_bytes)file_name*string原文件名(含扩展名 .csv / .xlsx,用于判来源)sourcealipay / wechat显式来源:alipay(支付宝)/ wechat(微信);空 = 按扩展名与内容自动判expense_add记一笔消费expense:write写限速active / pending、本月合计前后duplicate,不可绕过;疑似重复附 candidates,核对后带 ignore_similar=true 重调;unattended=true 一律落待确认amount*number金额,单位元,最多两位小数;支出为正、退款为负,不能为 0category*string分类 code,须在 expense_categories 清单内(food / transport / shopping / housing / utilities / entertainment / medical / education / social / other)merchant*string商户 / 收款方(≤ 60 字)time*string交易时间:RFC3339(如 2026-10-28T12:30:00+08:00)或 YYYY-MM-DD HH:MM(按东八区解);只给 YYYY-MM-DD 则记当天 00:00channelstring支付渠道(微信 / 支付宝 / 银行卡…,自由文本 ≤ 24 字)ext_refstring交易号 / 订单号(硬去重键:同号已存在即 duplicate 不可绕过)idempotency_keystring幂等键(按人唯一,保留 30 天):重试同一笔请带同一个键,命中返回首次结果且不再写ignore_similarbooleantrue = 已核对过疑似重复(duplicate 软命中)确认不是同一笔,放行落库locobject可选地点(经纬度落库取 3 位小数)notestring备注(≤ 40 字,如商品 / 项目摘要)unattendedboolean无人值守(Agent 自主、没人在场)= true:这笔一律落为待确认,由人之后在网页 / App 里放行;默认 false = 代人记账expense_update改一笔消费expense:write写限速unattended=true 一律 needs_confirmationid*string记录 idamountnumber改金额,单位元(退款为负);不传不改categorystring改分类 code;不传不改channelstring改支付渠道;不传不改clear_locbooleantrue = 清掉地点(优先于 loc)locobject改地点;不传不改merchantstring改商户;不传不改notestring改备注;不传不改(传空串 = 清空)timestring改交易时间,RFC3339 或 YYYY-MM-DD HH:MM;不传不改unattendedboolean无人值守 = true:自主姿态不改记录,会回 needs_confirmation;默认 falseversioninteger所见版本(expense_get / expense_list 返回的 version);过期 → conflict 附当前记录;0 / 不传 = 不比对,最后写入为准expense_delete删除一笔消费(软删除)expense:write写限速id*string记录 idunattendedboolean无人值守 = true(自主姿态只能删自己产生的待确认记录);默认 falseversioninteger所见版本;过期 → conflict;0 / 不传 = 不比对expense_restore恢复已删除的消费记录expense:write写限速id*string记录 idunattendedboolean无人值守 = true(自主姿态只能删自己产生的待确认记录);默认 falseversioninteger所见版本;过期 → conflict;0 / 不传 = 不比对expense_import_commit提交账单导入expense:write写限速unattended=true → needs_confirmationtoken*stringexpense_import_preview 返回的预览 token(有效 30 分钟,只能提交一次)decisionsobject每行的决定,键为预览行 index(字串),值为 add / skip / merge:<记录 id>;缺省行取预览的 suggested;skip_hard 行不能改为 addunattendedboolean无人值守 = true 会回 needs_confirmation(提交导入须人看过预览);默认 falseexpense_import_revoke撤销一次账单导入expense:write写限速batch_id*string导入批次 id(expense_import_commit 返回的 batch.id,或 expense_import_list 里的 id)expense_recurring_set登记 / 修改周期规则expense:write写限速amount*number每期金额,单位元,> 0(固定开销只有支出)category*string分类 code,须在 expense_categories 清单内period_day*integermonthly 时为每月几号 1..31(当月无此日取月末);weekly 时为周几 1..7(周一 = 1)period_kind*monthly / weekly周期:monthly(每月)/ weekly(每周)idstring要修改的规则 id(expense_recurring_list 返回的 rules[].id);不传 = 新登记一条(状态一律 manual 手动触发)merchantstring商户 / 收款方(≤ 60 字),如 房东、网易云音乐;到期时同金额、商户相似的生效记录已存在则该期跳过notestring备注(≤ 40 字),生成的每笔记录都带unattendedboolean无人值守 = true:自主姿态不能登记 / 改规则,会回 needs_confirmation;默认 falseversioninteger修改时的所见版本(rules[].version);过期 → conflict;0 / 不传 = 不比对expense_recurring_pause暂停 / 恢复周期规则expense:write写限速id*string规则 id(expense_recurring_list 返回的 rules[].id)pause*booleantrue = 暂停(到期不再生成,记下暂停前状态);false = 恢复(回到暂停前的状态,不会借机开自动)feedback_list我提过的反馈本人
feedback_get一条反馈的完整往来本人
feedback_image按句柄取一张附图本人读限速
feedback_create提交问题反馈 / 优化建议feedback:write写限速
feedback_reply在自己的反馈里追加消息feedback:write写限速
feedback_reply_retract撤回自己的一条消息feedback:write写限速
feedback_close结束自己的反馈feedback:write写限速
feedback_mark_read把处理方消息标为已读feedback:write写限速
feedback_list我的意见反馈本人versionstatusopen / done / all状态筛选:open(默认,普通 = 还没完结)/ done(已完结)/ all(全部)unread_onlybooleantrue = 只看有未读处理方消息的feedback_get一条反馈的往来本人items、允许的下一步 actions(普通:reply / close;已完结只剩 create_new)、所见 versionid*integer反馈 id(feedback_list 返回的 feedbacks[].id)feedback_image取一张反馈附图本人读限速content 里是 image,structuredContent.data_base64)name*string图片句柄(feedback_get 返回的 images / items[].images 里的一项,32 位十六进制 + .jpg / .png)feedback_create提交意见反馈feedback:write写限速url、摘要duplicate;每人每日 10 条content*string正文:现象、复现步骤、期望,≤2000 字title*string标题,一句话说清现象或建议,≤60 字type*bug / suggestion类型:bug(问题反馈)/ suggestion(优化建议)envobject可选环境信息(Agent 能拿到就附):如 host(宿主)/ page(页面地址)/ platform / version;≤16 项,值 ≤200 字;系统不校验真伪idempotency_keystring幂等键(按人保留 30 天;如对话片段指纹):重试同一条请带同一个键,命中返回首次结果且不再新建imagesarray附图,内联 base64(可带 data:image/png;base64, 前缀),≤3 张,解码后单张 ≤1MB,仅 jpg / pngunattendedboolean无人值守(Agent 自主、没人在场)= true:照常生效、计入 Agent 写额度,来源记为 Agent 自主;默认 false = 代人feedback_reply在反馈里追加消息feedback:write写限速state_invalid,要说别的就 feedback_create 新提一条并在正文引用旧 idid*integer反馈 idbodystring消息正文,≤1000 字;正文与附图至少其一idempotency_keystring幂等键:重试同一条消息请带同一个键,命中返回首次结果imagesarray附图,内联 base64,≤3 张,解码后单张 ≤1MB,仅 jpg / pngunattendedboolean无人值守 = true:照常生效、计入 Agent 写额度,来源记为 Agent 自主;答不了的问题留给人,别硬答;默认 falsefeedback_reply_retract撤回自己的一条消息feedback:write写限速message_id*integer要撤回的消息 id(feedback_get 的 items 里 kind=message、side=user 的 id)feedback_close结束自己的反馈feedback:write写限速unattended=true → needs_confirmationid*integer反馈 idversion*integer所见版本(feedback_get / feedback_list 返回的 version);过期 → conflict 附当前头notestring可选附言(落为一条你这边的消息),≤1000 字unattendedboolean无人值守 = true 一律 needs_confirmation(解没解决、要不要了只有人知道);默认 falsefeedback_mark_read把反馈标为已读feedback:write写限速id*integer反馈 id(feedback_list 返回的 feedbacks[].id)invalid / quota_exceeded,内容不会被截断instruction 指令(必填)→ summary 摘要 → levels 价位 → signals 信号 → steps 步骤 → snapshot 关键数字 → body 正文。格式只规定结构,每段里叫什么、有几条、写什么由你的 Agent 定。每份报告自带一整套:没给的段就是这份报告没有这一段,不沿用上一份analysis_state_get(拿全局记忆、各主题与最近一份报告 latest_report)→ 用行情工具取数 → 在 latest_report 上改,整份交给 analysis_report_add(带 idempotency_key);格式不对回 invalid 并指明哪一段哪个字段,改了重交style 约定为投资风格)与每个主题的。由 Agent 用 analysis_memory_set 写;页面上只看、不改unattended=true 照常生效,只记来源pushanalysis_state_get拿记忆、主题与各主题最近一份报告本人读限速
analysis_report_list翻历史报告本人读限速
analysis_report_get读一份报告全文与同步记录本人读限速
analysis_topic_set建或改一个主题(容器)analysis:write写限速
analysis_memory_set更新全局或某个主题的记忆analysis:write写限速
analysis_report_add按报告格式记一份报告并按设置同步analysis:write写限速
analysis_report_delete删除一份报告,可恢复analysis:write写限速
analysis_report_restore恢复删除的报告analysis:write写限速
analysis_state_get分析笔记状态本人读限速memory;每个主题的 key / type / title / enabled / sort / params / version、该主题的记忆 memory、报告份数 report_count、最近一份报告 latest_report(没有为 null):报告格式的同一形状,只是不带 body;urltopicstring只看这一个主题(股票代码或自定义短键,不论启用与否);空 = 全部启用的主题analysis_report_list翻历史报告本人读限速reports(只有指令与摘要,不含价位、信号、步骤与 body)、next_cursor、urlnext_cursor 就带回 cursor 取下一页topicstring只看这个主题的报告slotstring只看这个时段的报告(如 a_close)from · tostring交易日区间 YYYY-MM-DD,含两端statusactive / deleted / all缺省 active(未删除)limitinteger这一页最多几条,1..50,缺省 20cursorstring上一页结果的 next_cursoranalysis_report_get读一份报告本人读限速sync_log(每个通知源一条:source_name / kind auto 或 resend / status / reason)、urldeleted_at 非 0)id*string报告 id(analysis_report_list 的 reports[].id,或 analysis_report_add 的 report_id)analysis_topic_set建或改分析主题analysis:write写限速created、changed(值没变不写、版本不动)version,过期或不带回 conflict 附 current;主题只是容器,价位、信号、步骤随每份报告写(analysis_report_add);股票 / 期货 / 基金不给 title 则取行情里的名称;每人默认最多 50 个主题key*string主题键(带类型):股票用行情工具的代码写法,不带前缀(sz300308 / hk00700 / usNVDA,裸代码自动补市场前缀);期货 futures/<合约>(futures/rb2701,主力连续 futures/rb0);基金 fund/<6 位代码>(fund/025208);其它用自定义短键 [a-z0-9_]{1,24}(如 market)。返回里的 type(stock / futures / fund / custom)由键推出titlestring显示名 ≤24 字enabled · sortboolean · integer启用(缺省 true;关掉的不在全景卡出现,数据保留)与页面顺序paramsobject你自用的键值(≤2KB),原样存取、页面不画;整份替换,{} 清空versioninteger所见版本(analysis_state_get 返回);新建不带unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 falseanalysis_memory_set更新分析记忆analysis:write写限速removedtopicstring记在哪个主题下(须已存在);空 = 全局记忆itemsarray每条 key [a-z0-9_]{1,32}、text 一句话 ≤200 字必给;label ≤12 字首次必给、之后不传不改。全局里 style 约定为投资风格,页面排第一removearray要删的记忆 keyunattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 falseanalysis_report_add记分析报告analysis:write写限速report_id、url、replayed、同步结果 push:status sent / partial / failed / skipped、reason、code、items(每个源一条)invalid,reason 指明哪一段哪个字段(如 signals[2].as_of),内容不会被截断或改写idempotency_key 30 天内重放返回首次结果,不写第二份、不再投递sync_disabled 没开「收到报告时同步」/ no_sources 没勾选通知源 / push_false / quota_exhausted 当日投递次数用完 / notify_unavailable;前两种照 suggested_actions 请用户去账号设置idempotency_key*string幂等键,≤128 字slot*string时段标签 [a-z0-9_]{1,16}(如 a_close / hk_close / us_premarket / us_close / manual)instruction*string① 指令:一句 ≤80 字(页面上最醒目的一句,同步消息里加粗)topicstring挂在哪个主题下(须已存在);空 = 不挂主题slot_labelstring时段显示名 ≤12 字trade_datestring交易日 YYYY-MM-DD;空 = 东八区今天summarystring② 摘要 ≤300 字levelsarray③ 价位(≤6 条):label ≤12 字、price > 0、note ≤40 字;页面画成价位条signalsarray④ 信号(≤12 条):label ≤12 字、state green / yellow / red(页面画成实心 / 半心 / 空心圆)、evidence 一句依据 ≤120 字、as_of YYYY-MM-DD 必给;state_label ≤8 字;key [a-z0-9_]{1,32} 可空(你自己跨报告对齐用)stepsarray⑤ 步骤(≤8 条):label ≤12 字、text ≤120 字、status ≤8 字(显示给人的状态文字)、mark waiting(缺省)/ triggered / entered / failed / locked(决定圆点画法)snapshotarray⑥ 关键数字 {k, v, ref},≤40 行、≤8KB,页面画成三列表bodystring⑦ 正文:Markdown ≤20000 字,只在报告全文页展开modelstring署名:写这份报告的模型或 Agent 名(如 Claude Fable 5.2),≤40 字;页面在报告底部灰字显示pushboolean缺省 / true 跟随用户的「收到报告时同步」(不能越过用户关着的开关);false = 本次不同步unattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 falseanalysis_report_delete删除分析报告analysis:write写限速changed(已删除再删为 false)与报告头analysis_report_restore 恢复id*string报告 idunattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 falseanalysis_report_restore恢复分析报告analysis:write写限速changed(未删除再恢复为 false)与报告头quota_exceededid*string报告 idunattendedboolean无人值守(定时任务自主运行)传 true:照常生效,只记来源;默认 falseweekly_position_review—拉取我的持仓(按股汇总,由买卖记录推导)与每只近一周的日 K,列出持仓明细、今日与本周涨跌、盈亏变化,请模型做周度复盘。next_month_repayment—拉取我的借款,列出下个自然月每笔到期日、应还金额、利息 / 本金拆分与合计,请模型评估还款压力并给建议。fund_overlapcode*给定基金代码,拉取它的十大持仓与我的持仓,列出重合股票与权重,请模型分析集中度。health_review—拉取我自己设的财务健康目标与本站现状的对照,请模型按维度只复述 现状 / 目标 / 差额,不加任何建议record_positiontext把一笔股票买卖记进我的持仓(只记录,不下单):整理成交事实(股票、买 / 卖、日期、价、量、费用、是否信用及信用股数)并复述确认 → portfolio_record_add。可选参数 text 为成交原文。expense_recordtext看截图 / 读支付通知原文 → 读出金额、时间、商户、分类等字段并复述确认 → expense_add 记入;疑似重复先 expense_get 核对。可选参数 text 为要记的原文。expense_review_pending—拉取我全部待确认(status=pending)的消费记录列成表,请模型归类、点出异常与疑似重复并给每笔建议;确认 / 拒绝只能由本人在网页 / App 里做,Agent 不替人确认。feedback_reporttext把刚才碰到的问题或建议反馈给 chanshu:整理类型、标题、现象与环境信息 → 对照我未完结的反馈查重(同一问题改 feedback_reply 追加)→ 复述确认后 feedback_create。可选参数 text 为现象原文。isError,structuredContent = {error, retry_after_seconds}my_loans、alert_list、expense_categories、feedback_list、feedback_getstock_brief 不计quota_exceeded 附 reset_at、limit,当天别再重试stock_kline / futures_kline 一页 120 / 250 根;stock_margin 一页 20 / 60 / 250 个交易日;portfolio_record_list 一页最多 500 条按 end / cursor 翻页;整份数据在网页上点「导出」expense_quota 查quota_exceeded 附 reset_atneeds_confirmationneeds_confirmationquota_exceededneeds_confirmationquota_exceeded 附 reset_atquota_exceeded,删掉不需要的再写payload_too_large 附 limit_bytesisError=true 的结果,不是协议错误。消费、反馈、持仓、分析笔记四组带 structuredContent.error = {code, reason, suggested_actions} 与载荷(candidates / current / reset_at / limit_bytes …);负债、自选、提醒三组只有文本invalid消费 / 反馈 / 持仓 / 分析笔记按 reason 改参数not_found消费 / 反馈 / 持仓 / 分析笔记id 不对或不属于本人,重新列表找conflict消费 / 反馈 / 持仓 / 分析笔记所见 version 过期:重读,以 current.version 为准再决定duplicate消费 / 反馈消费:hard=true 不可绕过,疑似重复核对 candidates 后带 ignore_similar=true;反馈:改 feedback_reply 追加到 existing_idneeds_confirmation消费 / 反馈 / 持仓无人值守被拦或 Agent 额度用完:等人在场以代人姿态重调scope_missing持仓 / 分析笔记重新授权并勾上「管理我的持仓」或「记录分析笔记」token_not_allowed消费 / 反馈个人 API 令牌不能调,改用 OAuth 连接quota_exceeded行情原料 / 消费 / 反馈 / 分析笔记看 reset_at;行情类当天别再重试,识别可改为自己读图或文本模式payload_too_large消费 / 反馈按 limit_bytes 压缩或拆小limit消费 / 持仓记录数到上限,清理后再写already_imported消费同一账单已导过:expense_import_list 看批次,要重导先撤销preview_expired消费预览过期或已提交,重新预览recognize_failed消费识别不可用,自己读出字段直接 expense_addstate_invalid反馈按 allowed 换动作;已完结的不能追加,新提一条并在正文引用旧 idoversold持仓某笔卖出超过当时持股:补记买入或改日期unknown_stock持仓search_stock 拿带前缀的代码deleted持仓已删除的记录先 restore 再改not_deleted持仓没删,不用恢复sh600519 / sz000001 / hk00700 / usNVDA,指数同此(美股指数 us.IXIC / us.DJI / us.INX / us.NDX / us.SOX);基金 6 位数字;期货为品种 + 四位年月(rb2701,郑商所 SA701 也认)或品种 + 0 = 主力连续(rb0)asOf 给出行情所属交易日YYYY-MM-DDmkdir -p ~/.claude/skills/chanshu && curl -fsSL https://chanshu.top/docs/skill/SKILL.md -o ~/.claude/skills/chanshu/SKILL.mdtext/markdown)text/plain)cs_ 开头,请求头 Authorization: Bearer cs_…;给脚本、curl 或不支持 OAuth 的客户端用expense_draft / expense_import_preview(回 token_not_allowed)claude mcp add --transport http -s user chanshu https://chanshu.top/api/mcp --header "Authorization: Bearer <令牌>"[mcp_servers.chanshu]
url = "https://chanshu.top/api/mcp"
http_headers = { Authorization = "Bearer <令牌>" }{
"mcpServers": {
"chanshu": {
"url": "https://chanshu.top/api/mcp",
"headers": { "Authorization": "Bearer <令牌>" }
}
}
}curl https://chanshu.top/api/mcp \
-H "Authorization: Bearer <令牌>" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -H "Authorization: Bearer <令牌>" https://chanshu.top/api/debt/loans