tides

🌊 全球潮汐与海洋气象数据服务

基于第三方 API 的全球潮汐预测服务,支持实时潮高、极值计算及气象数据查询,适用于航海、渔业及海洋科研场景。

收藏
2.5k
安装
878
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

Tides Skill 是一款专注于全球海洋潮汐与气象数据查询的 API 文档型工具。该 Skill 通过 JSON-RPC 2.0 协议对接 hamandmore.net 提供的潮汐预测服务,为用户提供精准的海洋数据获取能力。

核心用法方面,用户可通过标准的 HTTP POST 请求调用四个主要工具函数:tides_time 获取服务器当前时间,tides_single 查询特定经纬度在指定时间的潮高数据,tides_extrema 计算某段时间内的潮汐极值(高潮与低潮),以及 weather_met 获取网格化的气象数据如风速、温度等。该服务支持匿名访问(免费层级)和 Bearer Token 认证(付费层级),用户需提供精确的经纬度坐标作为查询参数。

显著优点在于其纯粹的文档属性——作为纯 Markdown 文档,它不包含任何可执行代码或危险函数,彻底消除了代码注入和恶意执行的风险。API 文档结构清晰,提供了完整的 curl 命令示例,开发者可以快速上手集成。功能上覆盖全球任意位置的潮汐预测,同时整合气象数据,为海洋活动提供一站式数据支持。免费层级的存在也降低了试用门槛。

潜在缺点与局限性主要包括:首先,该服务完全依赖第三方 API(hamandmore.net),存在服务可用性风险,且无法离线使用;其次,免费层级存在速率限制,高频调用需要申请付费 Token;再次,数据来源为 T3 级别(个人或小团队维护),相比官方气象机构在权威性和数据更新频率上可能存在差距;最后,每次查询都需要将用户的地理位置信息发送至第三方服务器,存在隐私泄露隐患。

适合的目标群体主要包括:航海爱好者与渔民,用于规划出海时间;海洋科研人员,用于获取潮汐数据进行研究;海岸旅游开发者,用于预测海滩活动条件;以及需要集成潮汐数据的移动应用开发者。

使用风险方面,除上述地理位置隐私风险外,还包括网络依赖风险(无法本地计算潮汐)、第三方服务稳定性风险,以及免费层级的配额耗尽风险。建议在生产环境使用前,充分测试 API 稳定性并了解 hamandmore.net 的隐私政策。对于隐私敏感场景,建议寻找可本地部署的潮汐计算库替代。

安全解读

核心用法

tides Skill 是一组纯文档类 API 使用指南(T-MD 类型),帮助用户直接调用 hamandmore.net 的潮汐与气象数据服务。采用 JSON-RPC 2.0 协议,提供四大功能模块:

1. tides_time - 获取服务器当前时间,用于校准请求时间戳
2. tides_single - 查询指定经纬度、时间的单次潮位高度

3. tides_extrema - 获取指定时间段内的潮位极值(高潮/低潮)

4. weather_met - 查询气象网格数据(风速、温度等变量)

认证模式

  • 匿名访问:无 Authorization 头,受免费额度限制
  • Bearer/Basic Token:通过邮件申请更高额度,Basic 为不透明前缀而非 RFC 标准 Base64

显著优点

  • 全球覆盖:基于调和常数模型的海洋潮汐预测,不受实测站点限制
  • 协议标准化:JSON-RPC 2.0 接口,易于程序化集成
  • 多维度数据:潮汐+气象组合,满足航海、渔业、科研综合需求
  • 零依赖:纯文档 Skill,无本地代码执行风险

潜在缺点与局限性

  • 第三方依赖:所有数据请求发送至 hamandmore.net,存在服务可用性和连续性风险
  • 隐私考量:经纬度坐标上传至外部服务器,敏感区域使用需谨慎评估
  • 认证非标准:Basic 前缀设计不符合 RFC 7617,可能造成开发者困惑
  • 来源可信度:维护者为个人开发者(hamandmore@gmail.com),T3 级别,无企业 SLA 保障

适合人群

  • 海洋科研人员、港口调度员、帆船/钓鱼爱好者
  • 需要全球任意坐标潮汐预测(非仅验潮站)的开发者
  • 能接受外部 API 依赖且对数据隐私要求不极端敏感的用户

常规风险

  • 外部 API 服务条款变更或停止运营导致功能失效
  • 地理位置数据泄露风险(低敏感度场景可接受)
  • 免费额度耗尽后需邮件人工申请 Token,响应时效不确定

tides 内容

手动下载zip · 1.7 kB
SKILL.mdtext/markdown
请选择文件