k-skill 的 hankookilbo-news 技能实战无认证直连韩国日报官方 MCP 服务器查询新闻元数据【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill本指南围绕 k-skill 仓库中的hankookilbo-news技能展开讲解如何不经过任何代理与认证直接用curl调用韩国日报한국일보官方 MCP 端点https://mcp.hankookilbo.com/mcp查询头条、热门、最新、分节推荐、主题搜索与运势类文章的元数据。读完本文你将掌握该端点的完整契约Streamable HTTP、无状态单 POST 调用、10 种工具的参数用法、响应结构解析、工具选择与失败排障方法并能把同样的调用方式推广到其他同类公开 MCP 服务。这个技能能做什么hankookilbo-news是 k-skill 中面向韩国媒体的查询型lookup技能定位在 skill.json 的profiles: [lookup]与metadata.category: information中可明确看到。它直接对接韩国日报自营的公开 MCP 服务器核心能力包括查询编辑头条머리기사、最多阅读많이 본、仔细阅读꼼꼼히 본、时段推荐、最新文章等五种聚合列表按政治、经济、社会、国际、文化、体育、生活、人物、地区、观点共十个版块查询编辑推荐文章按主题、人物、事件关键词搜索新闻查询今日运势MBTI 运势对应的文章链接。需要特别强调的是该技能只返回文章元数据与简短摘录excerpt不会返回文章正文全文正文只能在item.url指向的原文页面查看。这是整个技能使用纪律的基石详见下文响应风格规范。最重要的规则端点契约与无状态设计该技能在 docs/features/hankookilbo-news.md 中开门见山地给出了三条铁律无需认证端点为https://mcp.hankookilbo.com/mcp是韩国日报直接运营的公开 MCP 服务器因此不经过k-skill-proxy中转从用户机器直接调用即可无状态调用服务器无状态不需要initialize握手、notifications/initialized通知、也不需要Mcp-Session-Id会话 ID一条 POST 直接发tools/call即可因此不需要安装任何 MCP SDK只用curl只返回元数据本技能只处理文章元数据和短摘录不返回正文。在 hankookilbo-news/instruction.md 的 Endpoint contract 一节中契约被进一步细化只允许POST使用GET、PUT、DELETE、OPTIONS均返回405Accept请求头必须同时包含application/json与text/event-stream两种值——这是 MCP Streamable HTTP 传输规范对客户端的要求即使服务端日后把响应切到 SSE 也不会破坏兼容完全省略该头则返回406User-Agent固定发送k-skill-hankookilbo/1.0韩国日报侧据此单独观测经由 k-skill 的流量。前置条件可用的互联网连接安装了curl可选安装了python3用于将 JSON 响应整理成易读列表。无需任何 API Key、令牌或配置文件这是本技能区别于 k-skill 中多数需要密钥技能的显著特点secrets.env.example 中也不需要为它配置条目。支持的 10 种工具一览工具说明必填参数list_top_headlines编辑部重点编排的头部文章머리기사无list_popular_news按浏览量的最多阅读排行无list_most_read_news主页另行评选的仔细阅读新闻无list_timely_news适配时段的推荐无list_latest_news按最近发布排序无list_recommended_articles按版块的编辑推荐无排名section_cdsearch_news按主题、人物、事件搜索querylist_sections版块代码列表无get_daily_horoscope今日运势文章无get_mbti_horoscopeMBTI 运势文章无注意上表中必填参数列来自功能文档的概览表从 instruction.md 的工具选择表可看到更细的参数维度如list_popular_news还支持可选的page_size、exclude_section_cd完整的参数矩阵见下文工具选择指南。基本调用curl 直连官方 MCP 端点请求头条列表curl -fsS --max-time 35 https://mcp.hankookilbo.com/mcp \ -H Content-Type: application/json \ -H Accept: application/json, text/event-stream \ -H User-Agent: k-skill-hankookilbo/1.0 \ -d {jsonrpc:2.0,id:1,method:tools/call,params:{name:list_top_headlines,arguments:{}}}逐项拆解这条命令--max-time 35给整条请求设置 35 秒上限。由于search_news的响应可能接近 30 秒统一用 35 秒作为安全阈值Content-Type: application/json声明 POST body 是 JSONAccept: application/json, text/event-stream必须两个值一起给这是 Streamable HTTP 规范要求缺了会得到 406详见失败模式body 中method: tools/call是 MCP 协议标准方法params.name指定具体工具params.arguments传参该例为空对象{}。因为服务器无状态id只是客户端自选的请求标识不需要会话上下文。按版块取热门文章并用 python3 整理curl -fsS --max-time 35 https://mcp.hankookilbo.com/mcp \ -H Content-Type: application/json \ -H Accept: application/json, text/event-stream \ -H User-Agent: k-skill-hankookilbo/1.0 \ -d {jsonrpc:2.0,id:1,method:tools/call,params:{name:list_popular_news,arguments:{section_cd:economy,page_size:5}}} \ | python3 -c import json,sys for i in json.load(sys.stdin)[result][structuredContent][items]: print(i[published_at], |, i[title], |, i[url])这个例子展示了完整的数据流先用参数化的tools/call请求经济版块section_cd: economy最多阅读前 5 条page_size: 5再把 JSON 响应用管道交给python3从result.structuredContent.items中逐条抽出发布时间、标题、原文链接。这正是 Agent 或脚本日常使用的标准模式。直接注册进 MCP 客户端可选除了用curl手工调用也可以把该端点直接注册到现成的 MCP 客户端中此时服务器下发的 instructions 也会一并传给客户端claude mcp add --transport http hankookilbo https://mcp.hankookilbo.com/mcp codex mcp add hankookilbo --url https://mcp.hankookilbo.com/mcp响应结构解析工具返回的 JSON 遵循 MCP 协议标准关键路径如下result.structuredContent.items文章数组整理列表时优先用这里的字段机器可读、结构稳定result.content[0].text面向人阅读的摘要文本每个items[]条目包含的字段article_id文章 ID、title标题、url原文链接、image_url缩略图链接、published_at发布时间、article_type_label文章类型标签、view_type原文可访问性、excerpt短摘录。三个需要注意的字段语义url会带上服务器追加的?didmcp来源参数向用户展示链接时不要删掉它这是韩国日报侧统计 MCP 流量的依据view_type为LoginWall时表示打开原文需要登录回答时要一并告知用户published_at的格式因工具而异例如2026.07.29 15:20或2026-07-28 10:27:02可以直接原样输出也可以按需重排成更利于用户阅读的格式。工具选择指南从用户发话到具体工具hankookilbo-news/instruction.md 给出了一张用户发话 → 工具 → 参数的映射表是 Agent 做意图识别时的直接依据用户发话示例工具参数헤드라인、오늘 주요 뉴스、제일 중요한 뉴스头条/今日要闻list_top_headlines无많이 본、인기 뉴스、지금 뜨는最多阅读/热门list_popular_newssection_cd、page_size、exclude_section_cd均可选꼼꼼히 본、정독할 만한仔细阅读/值得精读list_most_read_news无지금 볼만한、출근길에 볼 뉴스当下可看/通勤路上list_timely_news无최신 기사、방금 올라온最新文章list_latest_newspage_num、page_size可选分版块编辑推荐list_recommended_articlessection_cd必填、page_size主题/人物/事件搜索、왜 화제야为什么火search_newsquery必填、limit确认版块代码list_sections无오늘의 운세、띠별 운세今日/生肖运势get_daily_horoscopedate可选MBTI 운세get_mbti_horoscopedate可选section_cd 版块代码取值section_cd是版块维度的关键参数合法取值如下politics政治economy经济society社会world国际culture文化sports体育life生活people人物local地区opinion观点不要凭猜写代码不确定版块代码时先调用list_sections拉取服务端返回的权威列表再回填到section_cd。这能显著减少result.isError: true之类的参数错误。三种列表的定位差异功能文档与 instruction 都反复强调下面三种列表判定标准完全不同不能互相替换list_top_headlines——编辑部重点编排的头部文章代表媒体当日最重要的编辑判断list_popular_news——按浏览量排序的热门榜많이 본最多阅读特指这一种list_recommended_articles——按版块分发的编辑推荐不携带排名值。当用户说给我韩国日报头条时应调用list_top_headlines说给我最多阅读时应调用list_popular_news说给我今天政治版推荐时才轮到list_recommended_articles。标准工作流意图分类按上面的映射表把用户请求归类到具体工具涉及版块但不确定代码时先调用list_sections发起调用用curl单 POST 调用对应工具注意补全Accept双值与--max-time 35整理结果从result.structuredContent.items取前 35 条以标题 发布时间 原文链接的格式输出超时处理search_news响应可能接近 30 秒给足 35 秒上限一旦超时不要重试而是收窄查询词增加限定词、缩小时间范围等后重新询问一次。响应风格规范元数据纪律该技能对如何把元数据转述给用户有明确要求这是保证信息不失真的关键标题必须原文照引直接引用item.title禁止摘要、改写、省略号截断、符号替换或校对错别字否则会与真实报道标题产生偏差。最稳妥的呈现形式是제목超链接excerpt 不是全文摘要item.excerpt只是文章开头的一部分不能据此推断摘要之外的分析、评价、背景或结局正文只给链接全文只能在item.url查看不要尝试凭元数据重构正文内容登录墙如实告知item.view_type为LoginWall时明确告知用户打开原文需要登录列表不可随意截断只要items非空就说明该条件下确实存在文章不要自行删减条目运势工具的特殊性运势类工具不返回运势内容本身只返回文章标题、发布日期和原文链接具体运势内容引导用户到原文查看保留来源参数展示url时保留?didmcp不要删除。失败模式速查现象含义处理406 Not AcceptableAccept头缺失补上application/json, text/event-stream后重试405 Method Not Allowed用了非 POST 方法改为 POSTresult.isError: true工具参数错误如section_cd拼写错、query缺失检查参数必要时先用list_sections确认代码504search_news超过服务端时限禁止构建重试循环收窄查询词空items该条件下没有文章换版块或换查询词重试或如实回答没有连接失败韩国日报侧服务器故障禁止重试循环明确告知当前无法查询隐私边界该技能是无认证、无登录、无个性化的公开查询不要求也不应该出现任何密钥不请求、不存储文章正文全文不永久保存搜索词与查询结果。在仓库中的实现与集成从仓库结构看该技能采用了 k-skill 的标准三件套布局hankookilbo-news 目录instruction.md完整的运行时指令上文全部契约、工作流、失败模式的源文件skill.json技能清单name: hankookilbo-news、profiles: [lookup]、license: MIT、metadata.category: information、locale: ko-KR、phase: v1SKILL.mdCLI 生成的桩文档引导使用者通过npx -y nomadamas/k-skill0 instruct hankookilbo-news获取实时指令。该技能还随 k-skill CLI 一起打包分发对应副本位于 packages/k-skill-cli/skills/hankookilbo-news/instruction.md并有针对generic / dolshoi两种运行时的组装快照测试如 packages/k-skill-cli/test/snapshots/hankookilbo-news.generic.md说明其指令组装链路是受测试保护的稳定能力。小结hankookilbo-news是一个典型且极简的公开 MCP 端点直连技能无认证、无状态、单 POST、纯 curl 即可驱动 10 种查询工具。它的价值不仅在于让 Agent 拿到韩国日报的编辑判断头条、推荐、热门、运势更在于示范了一条可复制的接入路径——对任何遵循 MCP Streamable HTTP 规范且公开无鉴权的服务Accept双值头 tools/call单请求 structuredContent解析这套组合拳都可以照搬使用。使用中只需守住两条底线只传递元数据、不编造正文以及失败时不重试、先收窄再问。【免费下载链接】k-skill한국인을 위한 스킬 모음집 - 에이전트를 한국인으로项目地址: https://gitcode.com/GitHub_Trending/ks/k-skill创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考