AGENT SKILL

pm-the-guardian-api

The Guardian API connector knowledge and safe action guide.

License 许可
AGPL-3.0
所属仓库
polymetrics-ai/cli
最近更新
2026-09-21
Stars
★ 7
Forks
0

01 前言 Front Matter

name
pm-the-guardian-api
description
The Guardian API connector knowledge and safe action guide.

03 SKILL.md 正文

pm-the-guardian-api

Purpose

Reads Guardian content search results through the Guardian Open Platform Content API.

Icon

Capabilities

  • check=true catalog=true read=true write=false query=false
  • Integration type: api

Authentication

  • Use pm credentials add with --from-env or --value-stdin for secret fields.

Configuration

  • base_url
  • content_id
  • query
  • api_key (secret) (required)

ETL Streams

  • search:
    • primary key: id
    • cursor: published_at
    • fields: id(string), published_at(string), title(string)
  • tags:
    • primary key: id
    • fields: apiUrl(string), id(string), sectionId(string), sectionName(string), type(string), webTitle(string), webUrl(string)
  • sections:
    • primary key: id
    • fields: apiUrl(string), editions(array), id(string), webTitle(string), webUrl(string)
  • editions:
    • primary key: id
    • fields: apiUrl(string), edition(string), id(string), path(string), webTitle(string), webUrl(string)
  • content:
    • primary key: id
    • fields: apiUrl(string), id(string), isHosted(boolean), pillarId(string), pillarName(string), published_at(string), sectionId(string), sectionName(string), title(string), type(string), webUrl(string)

Sync Modes

  • ETL sync modes: full_refresh_append, full_refresh_overwrite, full_refresh_overwrite_deduped

Security

  • read risk: external Guardian Open Platform API read of published content search results
  • approval: none; read-only, no obviously-safe reverse-ETL writes
  • Never pass secret values in chat, shell arguments, logs, docs, or JSON output.

Commands

Inspect as a manual

pm connectors inspect the-guardian-api

Inspect as structured JSON

pm connectors inspect the-guardian-api --json

Agent Rules

  • Run pm connectors inspect the-guardian-api before creating credentials or plans.
  • Use --json only when the caller needs structured output; use the manual for human-readable guidance.
  • Never ask the user to paste secret values into chat.

04 同仓库更多 Skills