mcpField
T
travel-promos-argentina

travel-promos-argentina

github.com/ferminrp其他3956 次安装13 周前更新
代码仓库

关于 travel-promos-argentina

面向阿根廷旅行促销查询的 Skill，可获取机票、酒店和套餐优惠，并在本地筛选与排序。适用于查看当前促销，不包含预订或购买自动化。

主要功能

  1. 01从单一 API 端点获取旅行促销
  2. 02按类别、国家或文本筛选
  3. 03按日期或评分排序
  4. 04提供更新时间和促销链接

适用场景

  1. 01查找某目的地国家的机票优惠
  2. 02按类别比较近期促销
  3. 03查看评分最高的促销

安装

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

$npx skills add https://github.com/ferminrp/agent-skills --skill travel-promos-argentina

安装后在 Claude Code 中输入/travel-promos-argentina确认已加载。

详细介绍

阿根廷旅行促销

查询旅行促销（航班、酒店和套餐），并支持在本地筛选和排序。

API 概览

  • 基础 URL：https://anduin.ferminrp.com
  • 身份验证：无需
  • 响应格式：JSON
  • 主要端点：/api/v1/promos
  • OpenAPI：https://anduin.ferminrp.com/docs/openapi.json
  • 上游来源：data.source
  • 运营动态频道：https://t.me/comparaviajes（@comparaviajes），每小时发布新促销信息
  • 相关时间戳：
    • data.lastUpdated（促销信息更新时间）
    • timestamp（服务响应时间）
  • /api/v1/promos 的已记录查询参数：无
  • 说明：已测试的查询参数（category、destinationCountry、limit、q）不会在源端进行筛选；请使用 jq 在本地筛选（已根据当前端点响应验证）。

端点

  • GET /api/v1/promos

使用示例：

curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos[0:5]'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.category == "vuelos"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.category == "autos"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | map(select(.destinationCountry == "brazil"))'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | sort_by(.date) | reverse | .[0:10]'
curl -s "https://anduin.ferminrp.com/api/v1/promos" | jq '.data.promos | sort_by(-.score) | .[0:10]'

关键字段

  • 顶层：
    • success（bool）
    • timestamp（ISO 日期时间）
  • data：
    • lastUpdated（ISO 日期时间）
    • source（来源 URL）
    • totalPromos（int）
    • promos（数组）
  • promos[]：
    • id、date、title、permalink、thumbnailUrl
    • destinationCountry（可能为 null）
    • category
    • score（用于排名的数值；AI 分类失败时可能缺失）
  • 今日观察到的动态取值（示例，并非完整列表）：
    • category：vuelos、hoteles、autos、paquetes、asistencia、otros
    • destinationCountry：brazil、united_states、spain、dominican_republic、aruba、mexico、japan、portugal、europe、null
  • 其他语义：
    • permalink 会基于请求的主机动态构造为 /links/viajes/:id

工作流

  1. 判断用户意图：
    • 查看全部列表
    • 按类别或国家筛选
    • 按 score 排名
    • 查看最新促销
  2. 使用 curl -s 查询唯一端点。
  3. 验证 success == true 且 data.promos 存在。
  4. 使用 jq 在本地筛选和排序：
    • 按 category
    • 按 destinationCountry
    • 在适用时按 title 或 id 中的文本
    • 按 date 或 score
  5. 首先提供快照：
    • 总数量（totalPromos）
    • lastUpdated
    • 按 score 或相关性排名的前 3 项促销
  6. 然后显示简短表格（前 5/10 项）：
    • date | category | destinationCountry | score | title
  7. 仅为展示的促销提供 permalink。
  8. 保持回复内容翔实，不提供财务建议，也不保证促销可用。
  9. 如果用户要求实时了解最新信息，请说明也可以关注 @comparaviajes（https://t.me/comparaviajes）获取动态。

错误处理

  • HTTP 请求未成功：
    • 告知 HTTP 状态码和查询的端点。
  • 404（No promos data available）：
    • 告知当前没有缓存的促销数据。
  • success: false：
    • 如果存在错误载荷，则显示该载荷。
  • JSON 格式异常：
    • 显示最少但有用的原始内容，并说明数据不一致。
  • 网络错误或超时：
    • 短暂等待后最多重试 2 次。
  • promos 为空：
    • 告知“当前没有可用的促销”。

结果呈现

  • 默认格式：
    • 执行摘要 + 简短表格
  • 优先考虑：
    • 时效性（date）
    • 相关性（score）
    • 目的地和类别的清晰度
  • 说明时间戳（lastUpdated 和/或 timestamp）以及外部来源（data.source）。
  • 适用时，补充 Telegram 每小时动态的关注提示：https://t.me/comparaviajes。
  • 不提供购买建议；仅告知可用促销。

不在范围内

此技能在 v1 中不得执行以下操作：

  • 直接抓取外部网站
  • 自动预订或购买
  • 推送提醒、通知或变更跟踪
  • 使用 /api/v1/promos 以外的端点

评论

支持 Markdown