CtrlK
BlogDocsLog inGet started
Tessl Logo

ttfund-skills

天天基金官方 Skills 网关调用封装。 Use when: 查询天天基金/天天财富基金数据、基金搜索、基金净值、基金持仓、基金经理、指数、黄金、债市、活期宝或官方 ttfund skills。 Not for: 交易执行、券商/银行账户操作、FRED/Tushare/yfinance/AKShare 结构化数据源、投资建议。 Output: 通过官方网关返回的结构化 JSON 事实数据,带 source/asOf 后再进入 F207 数据层。 GOTCHA: 必须有本机 `TTFUND_APIKEY`,且 key 只放环境变量或 gitignored `.env`,绝不写入 git 或回复全文。

70

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

TTFund Skills

天天基金官方 Skills 是一个 HTTP 网关,不是开源 GitHub 包。所有能力共用 TTFUND_APIKEY,调用统一网关:

https://skills.tiantianfunds.com/ai-smart-skill-service/openapi/skill/invoke

官方安装说明:https://skills.tiantianfunds.com/ttfund-skills/ttfund-all-skills.md

When to Use

用它查天天基金体系内的基金事实数据:基金信息、历史净值、重仓持仓、基金经理、基金/指数搜索、黄金行情、债市行情、活期宝和模拟组合回测。

不要用它做真实交易、账户读取、买卖建议,也不要替代 FRED / Tushare / yfinance / AKShare 的市场宏观数据职责。F207 里它是基金数据 connector,进入 cat-cafe-finance 包装层后才能给分析层使用。

Quick Reference

# 列出已知 skill_id 和版本
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs list

# 基金搜索
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_SEARCH \
  '{"query":"沪深300","search_type":"fund","page_index":1,"page_size":5}'

# 基金综合信息
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_BASE_INFOS \
  '{"fcode":"000001","nav_range":"n"}'

# 基金净值
node cat-cafe-skills/ttfund-skills/scripts/ttfund-call.mjs FUND_NAV_INFO \
  '{"fund_id":"000001","range":"n"}'

脚本会按顺序读取:

  1. 当前进程环境变量 TTFUND_APIKEY
  2. 仓库根目录 .env
  3. 仓库根目录 .env

.env 已被 .gitignore 忽略;不要把 key 写进任何 tracked 文件。

Skill IDs

skill_idversion用途
FUND_BASE_INFOS1.2.0基金综合信息
FUND_MANAGER_INFO1.0.0基金经理信息
FUND_CONDITION_SELECT1.1.0条件选基
FUND_HOLDING_INFO1.0.0基金持仓
FUND_HUAAN_GOLD_INFO1.0.0黄金行情
FUND_TG_STRATEGY_INFO1.0.0投顾策略
FUND_INDEX_INFO1.0.0指数行情
FUND_NAV_INFO1.0.0基金净值
MODEL_PORTFOLIO1.0.0模拟组合回测/预览
FUND_FAVOR_ZX1.2.0自选管理
BOND_MARKET1.0.0债市行情
FUND_GROUP_BACKTEST1.0.0组合回测
FUND_SEARCH1.0.0基金/指数/经理/投顾搜索
FUND_STOCK_PRICE_QUERY1.0.0股票实时行情
FUND_THEME_INFO1.0.0基金主题
FUND_HUOQIBAO_LIST1.0.0活期宝

Common Mistakes

错误后果修复
把 API key 写进命令历史、文档或 git凭证泄露只放环境变量或 .env,回复中只写 masked key
让猫猫直接长期调用裸 ttfund 网关缺 source/asOf/cache/auditSpike 可以直连;正式 Phase B 走 cat-cafe-finance 包装层
忘记 _skill_version网关可能拒绝或走旧版本让脚本自动补版本,手写 curl 必须带版本
MODEL_PORTFOLIO 当真实交易违反 F207 交易边界只允许模拟/预览,不连接真实交易执行
把返回数据当投资建议越过分析师边界只作为事实数据,建议必须走 F207 分析/决策护栏

下一步

F207 B-spike 验证通过后,把这个 connector 纳入 cat-cafe-finance 的统一 schema / cache / provenance 层。

Repository
zts212653/clowder-ai
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.