首页 / 技能 / KTO TourAPI CLI — KTO TourAPI 命令行工具

📦 KTO TourAPI CLI — KTO TourAPI 命令行工具

v0.1.0

韩国旅游内容（관광지·문화시설·축제공연·여행코스·레포츠·숙박·쇼핑·음식점）通过한국관광공사 TourAPI 4.0（apis.data.go.kr/B551011/KorService2）。八个子命令封装areaCode2、cat...

0· 16·0 当前·0 累计
chloepark85 头像by @chloepark85 (Chloe Park)·MIT-0.
开发工具代码生成API开发数据分析数据可视化
下载技能包
License
MIT-0.
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
high confidence
The 技能's code and instructions match its 状态d purpose (wr应用ing the Korean TourAPI) but the published metadata omits required 环境 variables and required binaries, an inconsistency you should resolve before 安装ing.
评估建议
该 CLI 确实如其所言：调用 Korean TourAPI 并返回标准化的 JSONL。安装或启用前，请确认以下四点： (1) 该 skill 实际依赖 TOURAPI_SERVICE_KEY（解码密钥），但注册元数据未声明——请勿提供无关 secret； (2) 脚本本地需要 bash、curl、jq——确保这些二进制文件存在且可信； (3) 代码仅调用 apis.data.go.kr（官方 data.go.kr 主机），并用 mktemp/curl/jq 处理响应，无明显外泄，但仍需确认所有者/来源（无主页）——建议先选用已发布的仓库或已验证作者，再授予 skill 环境访问权限； (4) 若计划自动化，请考虑作用域：skill 将使用你的 TourAPI 密钥发起外发 HTTP 请求，请像对待任何 API secret 一样保管该密钥，必要时轮换/撤销。 若发布者能将注册元数据更新为列出 TOURAPI_SERVICE_KEY 及所需二进制文件，即可解决主要顾虑。...
详细分析 ▾
✓ 用途与能力
Name/description describe a 命令行工具 wr应用er for 한국관광공사 TourAPI 4.0; the scripts implement exactly that (area, nearby, 搜索, festival, stay, detAIl). The included scripts only call the TourAPI 端点s and normalize JSON 输出, which is coherent with the 状态d purpose.
ℹ 指令范围
技能.md and the scripts instruct the 代理 / user to 导出 TOURAPI_服务_KEY (the API decoding key) and to 运行 bash/curl/jq. The 运行time instructions do not 请求 unrelated files, 系统 data, or external 端点s beyond the documented APIs.data.go.kr domAIn. However the 技能.md and script behavior require an API key and certAIn binaries that are not declared in the registry metadata—this mismatch is notable.
✓ 安装机制
没有安装规范（仅含说明），因此不会从任意 URL 下载任何内容。仓库仅包含 bash 脚本和示例；安装步骤中不会安装任何软件包或获取远程代码。安装机制的风险较低。
⚠ 凭证需求
The 技能 requires a TOURAPI_服务_KEY (the TourAPI decoding key) and optionally TOURAPI_BASE / TOURAPI_移动_OS / TOURAPI_移动_应用; it also requires binaries (bash, curl, jq). The registry metadata clAIms 'Required env vars: none' and 'Required binaries: none', which is inconsistent and misleading. 请求ing the single TourAPI key is proportionate to the 状态d purpose, but the metadata omission is a problem and should be corrected before use.
✓ 持久化与权限
该技能未请求 always:true，不会修改其他技能或系统级配置，也未请求提升或持久的平台权限。允许自主调用（默认），但无额外持久权限。
安全有层次，运行前请审查代码。

License

MIT-0.

请查看许可证条款了解详情。

运行时依赖

无特殊依赖

安装命令

点击复制
官方npx clawhub@latest install kto-tourapi-cli
镜像加速npx clawhub@latest install kto-tourapi-cli --registry https://cn.longxiaskill.com

技能文档

kto-tourapi-cli 한국관광공사 TourAPI 4.0（KorService2）CLI 封装。由 한국관광공사（Korea Tourism Organization）官方维护，VisitKorea、대한민국 구석구석 及韩国主流旅行 App 的数据源。

8 个子命令，一一对应（或组合）官方端点：

  • scripts/area-code.sh → areaCode2：17 个广域市道 → 市郡区代码树
  • scripts/category-code.sh → categoryCode2：3 级 cat1/cat2/cat3 分类树
  • scripts/area.sh → areaBasedList2：按区域/市郡区/内容类型/分类浏览
  • scripts/nearby.sh → locationBasedList2：以 (lng, lat) 为中心 ≤20 km 半径搜索
  • scripts/search.sh → searchKeyword2：关键词搜索，可叠加区域/分类过滤
  • scripts/festival.sh → searchFestival2：指定日期窗口内的节庆活动
  • scripts/stay.sh → searchStay2：仅住宿（酒店、旅馆、韩屋等）
  • scripts/detail.sh → detailCommon2+detailIntro2+detailInfo2+detailImage2：一次性拉取 contentId 完整记录

输出统一 JSONL，一行一条，可直接管道给 jq、csvkit、pandas 或下游技能。

适用场景

  • 行程规划代理：area + nearby + festival 组合
  • 节庆日历：festival 输出转 JSON
  • K-content 采编：search → detail 获取图文
  • 地图附近发现：nearby 喂给 Kakao Map
  • 政府/NGO 权威数据：官方数据源，非众包

不适用

  • 实时价格、库存、预订：TourAPI 仅为内容目录，需对接 야놀자/여기어때/Booking.com 等
  • 用户评分/评论：请用 Naver Place/Kakao Map API
  • 英语/多语言：本技能仅封装 KorService2；EngService2 等未覆盖
  • 高并发公网应用：开发级配额 1,000 次/日，需去 data.go.kr 申请生产级

前置

  • https://www.data.go.kr/ 注册（免费，无需企业）
  • 申请 “한국관광공사_국문 관광정보 서비스_GW”（TourAPI 4.0 / KorService2），开发级自动通过
  • 复制 Decoding 原始 key（勿 URL encode）并导出
export TOURAPI_SERVICE_KEY='your_decoded_key_here' 可选： export TOURAPI_BASE='https://apis.data.go.kr/B551011/KorService2' export TOURAPI_MOBILE_OS='ETC' export TOURAPI_MOBILE_APP='your-app-name'

依赖：bash、curl、jq（macOS/Linux 默认自带）

参考代码 contentTypeId：12 관광지, 14 문화시설, 15 축제공연행사, 25 여행코스, 28 레포츠, 32 숙박, 38 쇼핑, 39 음식점 areaCode：1 서울, 2 인천, 31 경기, 32 강원, 33 충북, 34 충남, 35 경북, 36 경남, 37 전북, 38 전남, 39 제주, 6 부산, 7 대구, 8 광주, 9 대전, 10 울산, 11 세종 cat1：A01 자연, A02 인문, A03 레포츠, A04 쇼핑, A05 음식, B02 숙박, C01 추천코스

示例 강릉 관광지 10 条 bash scripts/area.sh --area-code 32 --sigungu-code 1 --content-type-id 12 --num 10

경복궁 500 m 内 음식점 bash scripts/nearby.sh --lng 126.9770 --lat 37.5797 --radius 500 --content-type-id 39

2026-05 济州节庆 bash scripts/festival.sh --start 20260501 --end 20260531 --area-code 39

“한옥” 숙소 검색 bash scripts/search.sh --keyword 한옥 --content-type-id 32 --num 30

경복궁 전체 레코드+이미지 bash scripts/detail.sh --content-id 264432 --content-type-id 14 --include-images

错误码 exit 64：CLI 参数错误 exit 78：未设置 TOURAPI_SERVICE_KEY exit 22：TourAPI 返回非 2xx 或 resultCode≠"0000" exit 127：缺失依赖

数据来源：ClawHub ↗ · 中文优化：龙虾技能库