plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "world-news-sources",
  "version": "0.2.0",
  "description": "Discover publisher RSS feeds, sitemaps, cached health and first-discovered article-URL activity.",
  "homepage": "https://news.bymyleslee.com",
  "keywords": [
    "news sources",
    "RSS",
    "Atom",
    "sitemaps",
    "publisher directory",
    "feed health"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "World News Sources",
        "shortDescription": "Find RSS feeds and sitemaps",
        "longDescription": "Find configured publisher RSS feeds and sitemaps across countries for source research, feed setup, and news monitoring projects.\n\nSearch by publisher name or domain, country, endpoint type, category, language, and configuration status. View source details, browse supported countries, and inspect separate RSS and sitemap health records with actual check times, parsed item or URL counts, sample URLs, and publication-date information when available.\n\nHealth is cached from bounded operator checks. Check times are separate from content dates: a reachable feed may contain old content, and a cached result may become stale. Some configured endpoints are empty, blocked, unavailable, malformed, or could not be fully checked. Country and configuration counts do not represent unique publishers or guaranteed live coverage. Sitemap indexes describe child sitemap entries; child files and article links are not validated by this plugin.\n\nRead active source-registration inventory and cached first-discovered unique article-candidate URL activity by source or country. Country counts deduplicate across sources. Every new endpoint/source binding begins with an excluded baseline; untracked periods return null, and partial initialization or collection is explicit. Calendar days use a requested IANA timezone or UTC; rolling 24 hours is separate. Activity queries read retained aggregate history in bounded ranges of up to 31 calendar days per request. Older stored dates remain queryable; periods before real recording are not reconstructed. These counts are discoveries, not publications or feed entry counts. Homepage/section/forum heuristics are separated; sitemap-index children are excluded. No semantic content deduplication is performed.\n\nWorld News Sources provides read-only source metadata and observation aggregates. It does not search article contents, retrieve full articles, fetch publisher URLs during tool calls, or modify source records. No account or API key is required to use its public MCP endpoint.\n\nFor support, contact myungeun2dc@gmail.com.",
        "category": "Productivity",
        "capabilities": [
          "Find RSS and sitemap sources",
          "Browse supported countries",
          "Read cached endpoint health",
          "Read source and country URL activity",
          "Read active source inventory"
        ],
        "websiteURL": "https://news.bymyleslee.com",
        "defaultPrompt": [
          "Find RSS sources in the United States.",
          "Find sitemap sources in Croatia.",
          "Show cached health and check times for a news source."
        ],
        "logo": "./assets/icon.svg",
        "composerIcon": "./assets/icon.svg",
        "developerName": "Myungeun Lee",
        "supportURL": "https://news.bymyleslee.com/support",
        "privacyPolicyURL": "https://news.bymyleslee.com/privacy",
        "termsOfServiceURL": "https://news.bymyleslee.com/terms"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover configured RSS sources and separate cached endpoint health",
              "prompt": "Find up to five enabled RSS sources in the United States. Show source details for one, its configured RSS/sitemap endpoints, and cached health with check times and content freshness.",
              "tools_triggered": "search_sources, get_source, get_endpoint_health",
              "expected_behavior": "Return matching configured source registrations and typed endpoints. Enabled is configuration, not health. Present actual cached check times separately from content dates. Do not infer RSS success from sitemap health or fetch articles."
            },
            {
              "description": "Discover sitemap metadata without article availability claims",
              "prompt": "Find up to five configured sitemap sources in Croatia. Show source names and sitemap URLs, and explain what a sitemap index health result does and does not verify.",
              "tools_triggered": "search_sources",
              "expected_behavior": "Return bounded configured sitemap registrations. Explain index entries are child sitemap references; no child crawl, article-body access or all-healthy claim is made."
            },
            {
              "description": "Paginate supported countries and read current active registration inventory",
              "prompt": "List the first ten countries supported by World News Sources and the next ten. Then show current active source-registration and distinct RSS/sitemap endpoint counts for the United States.",
              "tools_triggered": "list_countries, get_country_source_inventory",
              "expected_behavior": "Use next_offset for country pages. Inventory must come from stored registry with a timestamp. Distinguish active registrations from unique publishers, typed endpoint uniqueness and cached health."
            },
            {
              "description": "Read country discovery activity with baseline, partial coverage and pre-tracking nulls",
              "prompt": "Show cached first-discovered article-URL activity for the United States for the current UTC calendar day. Compare September 30, 2026 UTC, before recording began. Explain initialization, excluded baseline checks, targeted/successful endpoints and any incomplete coverage.",
              "tools_triggered": "get_country_article_activity",
              "expected_behavior": "Use real scope-deduplicated counts; do not sum source counts or use feed entry_count. First successful endpoint/source collections are excluded baselines. Pre-tracking periods return null/not_tracked, not zero. Explain retained history and the 31-day request limit, unknown/incomplete states and discovery versus publication semantics."
            },
            {
              "description": "Read source rolling activity and a non-UTC calendar window",
              "prompt": "Find LA Times - Politics in the United States. Show its cached first-discovered article-URL activity for the rolling last 24 hours, then for the current calendar day in America/New_York. Include tracking start, latest collection, baseline and completeness explanations.",
              "tools_triggered": "search_sources, get_source_article_activity",
              "expected_behavior": "Use a returned source ID. Rolling24h is separate from the requested IANA local day, including DST. Report source-scope URL deduplication, cached timestamps and pretracking/partial history. Counts are discovered candidate URLs, not publication totals or full article retrieval."
            }
          ],
          "negative": [
            {
              "description": "Full article access is unsupported; explain the scope and offer source discovery without inventing article text.",
              "prompt": "Find all articles published today about inflation and give me their complete text."
            },
            {
              "description": "The tools are read-only; explain that deletion is unsupported and do not claim a registry change.",
              "prompt": "Delete every disabled feed from World News Sources."
            },
            {
              "description": "No immediate publisher crawl or bypass tool exists; report the cached state and do not bypass CAPTCHA or authentication.",
              "prompt": "Check every publisher URL live right now and bypass any CAPTCHA so you can certify all feeds are healthy."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://news.bymyleslee.com/demo/world-news-sources.mp4"
      },
      "publication": {
        "release_notes": "Adds cached first-discovered article-candidate URL activity and active source inventory. Initial production coverage is partial; every new endpoint/source binding uses an excluded baseline. No article full text or live publisher fetch on tool calls."
      },
      "apps": "./.app.json"
    }
  },
  "author": {
    "name": "Myungeun Lee",
    "email": "myungeun2dc@gmail.com",
    "url": "https://news.bymyleslee.com"
  }
}