mcpField
H
hormuz-strait

hormuz-strait

github.com/himself65数据与数据库3.5k3.3k 次安装3 天前更新
代码仓库

关于 hormuz-strait

通过 Hormuz Strait Monitor 仪表板 API 获取霍尔木兹海峡公开状态数据的只读 Skill,无需身份验证。它覆盖船舶通行、油价、保险风险、外交状况及全球贸易影响,适用于航运与市场动态跟踪。

主要功能

  1. 01查询海峡状态与船舶通行
  2. 02查看油价和油轮运费
  3. 03跟踪滞留船只与保险风险
  4. 04汇总货运量和全球贸易影响
  5. 05查看外交动态、新闻与事件时间线

适用场景

  1. 01获取霍尔木兹海峡状态简报
  2. 02监测船舶流量与货运变化
  3. 03评估油价、保险和贸易影响

安装

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

$npx skills add https://github.com/himself65/finance-skills --skill hormuz-strait

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

附带文件README.mdreferences/api_schema.md

详细介绍

霍尔木兹海峡监测技能

从 霍尔木兹海峡监测 仪表板 API 获取霍尔木兹海峡的实时状态。涵盖船舶通行、油价、滞留船只、保险风险、外交局势、全球贸易影响和危机时间线。

此技能为只读。 它会获取公开的仪表板数据,无需身份验证。


第 1 步:获取仪表板数据

使用 curl 获取仪表板 API:

curl -s https://hormuzstraitmonitor.com/api/dashboard

解析 JSON 响应。API 返回 { "success": true, "data": { ... }, "timestamp": "..." }。

如果 success 为 false 或请求失败,请告知用户监测服务暂时不可用,并建议直接访问 https://hormuzstraitmonitor.com 查看。


第 2 步:确定用户的需求

将用户的请求与相关数据部分对应起来。如果用户询问总体状态,请展示所有部分;如果询问具体内容,则聚焦相关部分。

用户请求数据部分关键字段
总体状态 /“霍尔木兹海峡开放吗?”straitStatusstatus、since、description
船舶交通 / 通行数量shipCountcurrentTransits、last24h、normalDaily、percentOfNormal
油价影响oilPricebrentPrice、change24h、changePercent24h、sparkline
滞留 / 受困船只strandedVesselstotal、tankers、bulk、other、changeToday
保险 / 战争风险insurancelevel、warRiskPercent、normalPercent、multiplier
货运吞吐量throughputtodayDWT、averageDWT、percentOfNormal、last7Days
外交局势diplomacystatus、headline、parties、summary
全球贸易影响globalTradeImpactpercentOfWorldOilAtRisk、estimatedDailyCostBillions、affectedRegions、lngImpact、alternativeRoutes、supplyChainImpact
危机时间线 / 事件crisisTimelineevents[],包含 date、type、title、description
油轮运费 / VLCC 运价tankerRatescurrentRate、preCrisisRate、changePercent、route、vesselType、trend、unit
最新新闻newstitle、source、url、publishedAt、description

第 3 步:展示数据

以清晰的格式呈现金融研究结果。根据用户的提问调整展示方式。

总体状态简报(默认)

用户询问总体情况时,请涵盖以下部分——船舶通行正常时,每项用一行说明;出现实际中断时,则提供更详细的信息:

  1. 海峡状态 — 首先说明当前状态(例如“开放”“受限”“关闭”)、该状态已持续多久,以及状态描述
  2. 船舶交通 — 当前通行量、过去 24 小时的数量,以及正常水平的百分比
  3. 油价 — 布伦特油价及过去 24 小时的变化
  4. 滞留船只 — 按类型细分的船只总数,以及今日变化
  5. 保险风险 — 风险等级、战争风险保费百分比,以及相对于正常水平的倍数
  6. 货运吞吐量 — 今日载重吨数(DWT)与平均值的对比,以及正常水平的百分比
  7. 外交状态 — 当前状态、标题和简要摘要
  8. 全球贸易影响 — 面临风险的全球石油比例、每日估算成本,以及受影响最大的地区
  9. 油轮运费 — 基准航线当前 VLCC 运价与危机前基准的对比,并说明趋势方向
格式指南
  • 对结构化数据(船只数量、受影响地区、替代航线)使用表格
  • 突出显示异常数值——如果 percentOfNormal 低于 80% 或高于 120%,请特别指出
  • 对于 oilPrice.sparkline,描述趋势(上涨、下跌、稳定),而不是逐一列出原始数字
  • 对于 throughput.last7Days,描述趋势方向
  • 显示 lastUpdated 时间戳,让用户了解数据的新鲜度
  • 对新闻条目,附上来源和链接
  • 对危机时间线事件,按时间顺序列出并标注事件类型
风险评估

根据数据,提供简短的风险评估。insurance.level 的值均为大写:

保险等级说明
NORMAL无升高的风险——航运正常运行
ELEVATED存在一些中断隐忧——密切关注
HIGH风险显著——正在发生中断或存在可信威胁
CRITICAL中断严重——对全球石油供应造成重大影响
EXTREME实际关闭——战争风险保费达到数十年来最高水平,大多数商业交通已停止

如果海峡状态并非完全开放,请重点说明:

  • 全球贸易的每日预估成本
  • 受影响最大的地区及其对石油的依赖程度
  • 可用的替代路线,以及增加的航行天数和成本
  • LNG 影响(如适用)
  • SPR(战略石油储备)可供应的天数

第 4 步:回复用户

  • 首先说明最重要的信息:海峡状态和当前发生的任何中断
  • 包含数据更新时间(lastUpdated 时间戳)
  • 如果情况已升高或更严重,主动提供全球贸易影响摘要
  • 对于常规的“一切正常”状态,回复应简洁;对于正在发生的事件,则应展开说明
  • 添加免责声明:数据来源于 Hormuz Strait Monitor,可能存在延迟

参考文件

  • references/api_schema.md — 完整的 API 响应架构,包含字段说明和数据类型

需要准确的字段名称或数据类型详情时,请阅读参考文件。

评论

支持 Markdown