Back to Details

panews

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
Public read-only PANews content via 
https://universal-api.panewslab.com
. Set the 
PA-Accept-Language
request header to localize responses.
Current first-class support in this skill is limited to the bundled scripts below. Other public endpoints may appear in references as HTTP notes, but they are not part of the default supported workflow unless scripts are added later.
通过
https://universal-api.panewslab.com
获取PANews的公开只读内容。设置
PA-Accept-Language
请求头可实现响应本地化。
目前该技能仅优先支持以下内置脚本。其他公开端点可能会在参考资料中以HTTP注释形式出现，但除非后续添加脚本，否则它们不属于默认支持的工作流。

When to Use

使用场景

  • The user wants structured JSON data from the PANews API
  • The task is article discovery, article detail lookup, rankings, or daily must-reads
  • The caller needs stable filters such as 
    columnId
    , 
    tagId
    , 
    authorId
    , or article type
  • 用户需要从PANews API获取结构化JSON数据
  • 任务涉及文章发现、文章详情查询、排行榜或每日必读内容获取
  • 调用方需要使用
    columnId
    、
    tagId
    、
    authorId
    或文章类型等稳定过滤条件

Do Not Use When

不适用场景

  • The user wants the rendered website page body or layout-aware Markdown output
  • The task requires authentication, publishing, or creator-only routes
  • The request is really about a PANews web URL rather than API data
  • 用户需要渲染后的网页正文或布局相关的Markdown输出
  • 任务需要认证、发布或创作者专属路由
  • 请求实际是针对PANews网页URL而非API数据

Standard Workflow

标准工作流

Copy this checklist and work through it:
text
PANews Read Progress:
- [ ] Step 1: Decide API JSON vs website Markdown
- [ ] Step 2: Set locale (default: zh)
- [ ] Step 3: Pick the narrowest bundled script that matches the task
- [ ] Step 4: Retry once with a broader query if results are empty
- [ ] Step 5: Return the result with any filters or caveats called out
复制以下检查清单并按步骤执行：
text
PANews 读取进度：
- [ ] 步骤1：确定使用API JSON数据还是网页Markdown
- [ ] 步骤2：设置区域语言（默认：zh）
- [ ] 步骤3：选择与任务最匹配的最窄范围内置脚本
- [ ] 步骤4：如果结果为空，使用更宽泛的查询重试一次
- [ ] 步骤5：返回结果并标注所有过滤条件或注意事项

Language

语言设置

LanguageHeader value
Simplified Chinese
zh
Traditional Chinese
zh-hant
English
en
Japanese
ja
Korean
ko
语言请求头值
简体中文
zh
繁体中文
zh-hant
英文
en
日语
ja
韩语
ko

Rules

规则

  • Always use 
    POST /search/articles
    for keyword search — never 
    GET /articles?search=...
  • Default 
    mode=hit
    ; use 
    mode=time
    only when the user explicitly wants newest results
  • Default article types 
    NORMAL,NEWS
    ; add 
    VIDEO
    only when the user explicitly asks
  • This skill is read-only — for article creation and publishing use 
    panews-creator
  • Prefer bundled scripts before falling back to ad hoc HTTP requests
  • Treat reference-only endpoints as optional HTTP notes, not as default supported workflows
  • 关键词搜索必须使用
    POST /search/articles
    ，禁止使用
    GET /articles?search=...
  • 默认
    mode=hit
    ；仅当用户明确要求最新结果时才使用
    mode=time
  • 默认文章类型为
    NORMAL,NEWS
    ；仅当用户明确要求时才添加
    VIDEO
  • 该技能为只读模式——文章创建与发布请使用
    panews-creator
  • 优先使用内置脚本，再考虑临时HTTP请求
  • 仅将参考用端点视为可选HTTP注释，而非默认支持的工作流

Failure Handling

故障处理

  • If a search query returns no results, retry once with a broader keyword or fewer filters
  • If article detail returns 
    404
    , report the article as unavailable instead of silently switching sources
  • If the request is really for a public webpage, route to 
    panews-web-viewer
  • 如果搜索查询无结果，使用更宽泛的关键词或更少的过滤条件重试一次
  • 如果文章详情返回
    404
    ，需报告该文章不可用，而非静默切换数据源
  • 如果请求实际是针对公开网页，路由至
    panews-web-viewer

Scripts

脚本示例

bash
node {Skills Directory}/panews/scripts/search-articles.mjs <query> [--mode hit|time] [--type NORMAL,NEWS] [--take 10] [--skip 0] [--lang zh]
node {Skills Directory}/panews/scripts/list-articles.mjs [--type NORMAL|NEWS|VIDEO] [--column-id <id>] [--tag-id <id>] [--author-id <id>] [--is-featured] [--take 10] [--skip 0] [--lang zh]
node {Skills Directory}/panews/scripts/get-article.mjs <articleId> [--related] [--lang zh]
node {Skills Directory}/panews/scripts/get-daily-must-reads.mjs [--date YYYY-MM-DD] [--special] [--lang zh]
node {Skills Directory}/panews/scripts/get-rankings.mjs [--weekly] [--lang zh]
bash
node {Skills Directory}/panews/scripts/search-articles.mjs <query> [--mode hit|time] [--type NORMAL,NEWS] [--take 10] [--skip 0] [--lang zh]
node {Skills Directory}/panews/scripts/list-articles.mjs [--type NORMAL|NEWS|VIDEO] [--column-id <id>] [--tag-id <id>] [--author-id <id>] [--is-featured] [--take 10] [--skip 0] [--lang zh]
node {Skills Directory}/panews/scripts/get-article.mjs <articleId> [--related] [--lang zh]
node {Skills Directory}/panews/scripts/get-daily-must-reads.mjs [--date YYYY-MM-DD] [--special] [--lang zh]
node {Skills Directory}/panews/scripts/get-rankings.mjs [--weekly] [--lang zh]

References

参考资料

TopicDescriptionReference
WorkflowsTask routing, defaults, and empty-result handlingworkflows
ArticlesSearch, list, detail, related articles, and rankingsarticles
ContentDaily must-reads plus reference-only notes for adjacent public endpointscontent
主题描述参考链接
工作流任务路由、默认设置与空结果处理workflows
文章搜索、列表、详情、相关文章及排行榜articles
内容每日必读内容及相邻公开端点的仅参考注释content