← Back to Skills Marketplace
forest-qiao

Gold Monitor Skill

by forest-qiao · GitHub ↗ · v2.2.0 · MIT-0
cross-platform ✓ Security Clean
381
Downloads
1
Stars
2
Active Installs
4
Versions
Install in OpenClaw
/install gold-monitor
Description
查询实时金价、黄金价格、美元指数、原油价格、金油比及投资建议。Query real-time gold price (Au99.99/COMEX/XAU), USD index (DXY), WTI oil price, and Gold/Oil ratio with investment signals. 支持...
README (SKILL.md)

Gold Monitor

实时贵金属与大宗商品价格查询工具,含金油比(Gold/Oil Ratio)投资信号分析。数据来源:上海黄金交易所 (SGE)、COMEX、新浪财经。

When to Use

Use this skill when the user asks about:

  • 金价 / 黄金价格 / 今日金价 / 实时金价 / gold price / gold rate
  • 国际金价 / COMEX金价 / XAU/USD / XAUUSD / 伦敦金
  • 中国金价 / 国内金价 / Au99.99 / 上海金 / SGE金价
  • 美元指数 / DXY / USD index / 美元走势
  • 原油价格 / 油价 / WTI / crude oil / 国际油价
  • 大宗商品行情 / 贵金属行情 / commodity prices
  • 金价走势 / 金价涨跌 / 黄金涨了吗 / 金价多少
  • 金油比 / gold oil ratio / 黄金原油比 / 大宗商品投资信号 / 现在适合买黄金吗

Setup

Before first use, install dependencies:

pip install -r {{SKILL_DIR}}/requirements.txt

Usage

Query all assets at once (includes gold-oil ratio):

python3 {{SKILL_DIR}}/query.py all

Query a single asset:

python3 {{SKILL_DIR}}/query.py AU9999    # China gold (CNY/gram)
python3 {{SKILL_DIR}}/query.py XAUUSD   # International gold (USD/oz)
python3 {{SKILL_DIR}}/query.py USIDX    # USD index (DXY)
python3 {{SKILL_DIR}}/query.py WTI      # WTI crude oil (USD/barrel)
python3 {{SKILL_DIR}}/query.py GORATIO  # Gold/Oil ratio + investment advice

Output

For price assets, the script prints JSON to stdout:

{
  "name": "国际黄金 COMEX",
  "symbol": "XAUUSD",
  "price": 3050.12,
  "change": 15.30,
  "change_pct": 0.50,
  "unit": "USD/oz",
  "update_time": "2026-03-27 10:30:00"
}

For GORATIO, the output includes ratio value, level, signal, and advice:

{
  "symbol": "GORATIO",
  "name": "金油比",
  "ratio": 32.5,
  "gold_price": 3050.12,
  "oil_price": 93.85,
  "level": "偏高",
  "signal": "🟠 避险情绪偏强",
  "advice": "金油比高于历史均值,反映经济下行预期...",
  "update_time": "2026-03-27 10:30:00"
}

For all, the output is an array of 5 objects (4 prices + 1 ratio).

If an "error" field is present, that asset's data could not be fetched — tell the user.

Gold/Oil Ratio Reference

Level Range Signal Meaning
极度偏高 >40 🔴 Recession/crisis signal (COVID 2020 peak ~70)
偏高 25-40 🟠 Risk-off sentiment, economic slowdown
正常 15-25 🟡 Historical average (~16-17), balanced
偏低 10-15 🟢 Economic expansion, commodities strong
极度偏低 \x3C10 🔵 Oil overvalued / inflation shock

Parse the JSON and present prices clearly with values, changes, and units. For GORATIO, highlight the signal and present advice as investment guidance.

Network Access

This skill makes outbound HTTP requests to the following hosts only:

  • hq.sinajs.cn — Sina Finance real-time quotes (international gold, USD index, WTI oil)
  • akshare API endpoints — Shanghai Gold Exchange data (China gold Au99.99)

No credentials or API keys are required. All requests are read-only.

Data Sources

  • China Gold (Au99.99) — Shanghai Gold Exchange via akshare
  • International Gold (COMEX) — Sina Finance real-time quotes
  • USD Index (DXY) — Sina Finance real-time quotes
  • WTI Crude Oil — Sina Finance real-time quotes
  • Gold/Oil Ratio — Computed from COMEX gold ÷ WTI oil
Usage Guidance
This skill appears coherent: it fetches market quotes (via hq.sinajs.cn and akshare) and computes a gold/oil ratio with investment commentary. Before installing, consider: (1) running the code in a sandbox or isolated environment and reviewing akshare's network behavior (akshare may contact additional endpoints), (2) be aware pip will install akshare and requests (check versions and upstream trust), (3) the investment 'advice' is programmatic guidance, not professional financial advice, and (4) rate limits or data changes at the upstream endpoints could cause errors. If you need stricter network controls, inspect akshare's source or run the script with network egress limited to the declared hosts.
Capability Analysis
Type: OpenClaw Skill Name: gold-monitor Version: 2.2.0 The gold-monitor skill is a legitimate financial data tool that fetches real-time prices for gold, oil, and the USD index using the 'akshare' library and Sina Finance APIs (hq.sinajs.cn). The code in query.py is straightforward, performing data retrieval and calculating the gold/oil ratio without any indicators of malicious behavior, data exfiltration, or unauthorized execution.
Capability Assessment
Purpose & Capability
Name/description (gold, USD index, WTI, G/O ratio) align with the included files and runtime: query.py implements fetchers for AU9999, XAUUSD, USIDX, WTI and computes GORATIO. Declared data sources (Sina + akshare/SGE) match the code.
Instruction Scope
SKILL.md instructs the agent to run the provided CLI script and parse JSON output. The script only performs read-only network calls and local calculations; it does not read arbitrary files, environment variables, or other system state beyond argv.
Install Mechanism
No install spec in registry; SKILL.md directs a simple pip install of akshare and requests. Dependencies are reasonable and expected for this task. No downloads from untrusted URLs or archive extraction are present.
Credentials
The skill requires no environment variables, credentials, or config paths. All network requests are to Sina's quote endpoint and to whatever akshare uses; no secret access is requested.
Persistence & Privilege
Skill is user-invocable and not always-enabled. It does not request permanent presence, modify other skills, or alter system/agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gold-monitor
  3. After installation, invoke the skill by name or use /gold-monitor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.2.0
新增金油比(GORATIO)查询及五档投资建议信号
v2.1.0
- Expanded and clarified SKILL.md documentation, including clearer usage instructions and output examples. - Added detailed setup and network access sections for easier installation and understanding of data flow. - Updated asset descriptions and documentation of data sources for all supported commodities. - No code changes in query.py or requirements.txt are detailed; updates focus on improving user guidance and transparency.
v2.0.0
gold-monitor 2.0.0 - Major simplification: monitoring dashboard, web UI, alerts, and scheduler removed - All API and dashboard code deleted; now exposes only a single query script (query.py) - Requirements significantly reduced; removed external dependencies and setup steps - Usage is now command-line only for querying current gold, USD index, and oil prices - Outputs data as JSON for easy parsing; error handling clarified in documentation
v1.0.0
- Initial release of gold-monitor. - Real-time monitoring dashboard for gold prices (China Au99.99 & COMEX), USD index (DXY), and WTI crude oil. - Configurable price alerts with Feishu (Lark) webhook notifications. - REST API endpoints for prices, historical data, and alert management. - Web dashboard available at http://127.0.0.1:8000. - Alert settings and webhook configuration are persisted automatically. - Supports flexible alert conditions and polling every 60 seconds.
Metadata
Slug gold-monitor
Version 2.2.0
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 4
Frequently Asked Questions

What is Gold Monitor Skill?

查询实时金价、黄金价格、美元指数、原油价格、金油比及投资建议。Query real-time gold price (Au99.99/COMEX/XAU), USD index (DXY), WTI oil price, and Gold/Oil ratio with investment signals. 支持... It is an AI Agent Skill for Claude Code / OpenClaw, with 381 downloads so far.

How do I install Gold Monitor Skill?

Run "/install gold-monitor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Gold Monitor Skill free?

Yes, Gold Monitor Skill is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Gold Monitor Skill support?

Gold Monitor Skill is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Gold Monitor Skill?

It is built and maintained by forest-qiao (@forest-qiao); the current version is v2.2.0.

💬 Comments