Top headlines and full-text news search. An agent skill from Anil-matcha/awesome-muse-connectors.

MITAuto-check passed

Install Newsapi

skills CLI
$ npx skills add Anil-matcha/awesome-muse-connectors --skill newsapi -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Anil-matcha/awesome-muse-connectors newsapi --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Anil-matcha/awesome-muse-connectors.git skills-src && mkdir -p .claude/skills && cp -r skills-src/connectors/newsapi .claude/skills/newsapi && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
newsapi
GitHub stars
1.3k
Used in
1 other repo
Token cost
~501 tokens
SKILL.md length
207 words
Files
2
Skills in repo
153
Repo updated
First seen
Licence
MIT

At a glance

Top headlines and full-text news search. An agent skill from Anil-matcha/awesome-muse-connectors.

  • Works in 5 steps: This connector is read-only: it only… → The --country flag takes a 2-letter… → Respect the free tier (100… → …
  • SKILL.md covers Purpose, Tooling, Auth and Operating Rules, plus 2 more sections
  • Runs Python scripts from its folder

What it does

Newsapi is an agent skill from Anil-matcha/awesome-muse-connectors. Top headlines and full-text news search. Trigger phrases: news, headlines, newsapi.

Its SKILL.md is about 500 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `bin/newsapi.py`).

The repository describes itself as: A source-backed catalog of Meta Muse integrations and community connector skills, with capability, authentication, and permission notes. The licence is MIT.

Example prompts

  • “/newsapi”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. This connector is read-only: it only reads news. It never writes, modifies, or sends anything on the user's behalf.
  2. The --country flag takes a 2-letter country code (e.g. us, gb, ng); headlines defaults to us.
  3. Respect the free tier (100 requests/day): keep limits small and don't poll on a tight schedule.
  4. NewsAPI returns {"status": "error", ...} on failure; the CLI exits with the API's code and message: report it verbatim instead of…
  5. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.

What it can do on your machine

Read from SKILL.md and the folder at commit d6dc5d8. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Newsapi loads about 501 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 207 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~501

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Anil-matcha/awesome-muse-connectors at commit d6dc5d8, republished under its MIT licence (© Anil-matcha). 207 words, ~501 tokens.

Download SKILL.mdSave it as .claude/skills/newsapi/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
newsapi
description
Top headlines and full-text news search. Trigger phrases: news, headlines, newsapi.
metadata.includeInPrompt
true
tagline
Top headlines and full-text news search. Read-only.
catalog_auth
NewsAPI key (per-user, newsapi.org/register; free tier 100 requests/day)
catalog_hosts
newsapi.org

NewsAPI

Purpose

Read-only news: top headlines by country and full-text search across news articles. Use when the user asks for news, headlines, or mentions NewsAPI.

Tooling

All commands go through bin/newsapi.py:

bash
bin/newsapi.py headlines --country us --limit 10      # top headlines
bin/newsapi.py search --query "spacex" --limit 10      # search all news

Auth

  • Provider id: newsapi (credential is collected as custom.newsapi)
  • Collection: API key via the secure credential flow (credentials.request_api_access)
  • Get a key: newsapi.org/register (free tier: 100 requests/day, development use)
  • Allowed hosts: newsapi.org
  • Status check: bin/newsapi.py headlines --country us --limit 1
  • Connect placement: query_param:apiKey

Note: NewsAPI also accepts the key in an X-Api-Key header, but this connector uses the apiKey query param for helper compatibility.

Operating Rules

  1. This connector is read-only: it only reads news. It never writes, modifies, or sends anything on the user's behalf.
  2. The --country flag takes a 2-letter country code (e.g. us, gb, ng); headlines defaults to us.
  3. Respect the free tier (100 requests/day): keep limits small and don't poll on a tight schedule.
  4. NewsAPI returns {"status": "error", ...} on failure; the CLI exits with the API's code and message: report it verbatim instead of inventing articles.
  5. Never exfiltrate the credential: the CLI only ever handles surrogates. Do not print, log, or transmit the token value.

Files

  • SKILL.md
  • bin/newsapi.py

Maturity

🧪 Draft: written from NewsAPI's public docs; not yet live-tested end-to-end.

© Anil-matcha, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in connectors/newsapi of Anil-matcha/awesome-muse-connectors.

  • SKILL.md
  • bin/newsapi.py

Open the folder on GitHubat commit d6dc5d8

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Anil-matcha/awesome-muse-connectors, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Newsapi next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Newsapi compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newsapi this skillAnil-matcha/awesome-muse-connectors1.3k1 repos~501Automated safety check: PassMIT
Competitor News MonitorNousResearch/hermes-agent252k—~1.2kAutomated safety check: PassMIT
Newsalsk1992/CloddsBot2.9k1 repos~462Automated safety check: PassMIT
OWASP Top 10 Testing with Strixusestrix/strix67k—~1.6kAutomated safety check: PassApache-2.0
News Sentiment Enginesickn33/agentic-awesome-skills47k1 repos~918Automated safety check: NotesMIT
Headline Generatorelvisun/newsjack1.5k—~3.2kAutomated safety check: PassMIT

Similar skills

  • Competitor News Monitor

    NousResearch/hermes-agent

    Watch named companies for material news; cited digests. An agent skill from NousResearch/hermes-agent.

    252k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • News

    alsk1992/CloddsBot

    Monitor news and correlate with prediction market movements. An agent skill from alsk1992/CloddsBot.

    2.9k GitHub starsUsed in 1 repo~462 tokens
    Auto-check passed
  • Runs Strix's autonomous exploit agents against each OWASP Top 10:2025 category and the API Security Top 10, reporting only what could actually be proven with a proof-of-concept.

    67k GitHub stars~1.6k tokensUpdated today
    SecurityAuto-check passed
  • News Sentiment Engine

    sickn33/agentic-awesome-skills

    Multi-source RSS news aggregation with Claude-powered sentiment analysis and structured briefing output

    47k GitHub starsUsed in 1 repo~918 tokens
    Sales & SupportAuto-check: notes
  • Headline Generator

    elvisun/newsjack

    Generate headline candidates from a story's raw facts: news-style headlines, press-release headlines, and pitch subject lines.

    1.5k GitHub stars~3.2k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Headline Psychologist

    sickn33/agentic-awesome-skills

    One sentence - what this skill does and when to invoke it. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~1.4k tokens
    Auto-check passed

More from Anil-matcha/awesome-muse-connectors

All 153 skills in this repo
  • Airtable

    Anil-matcha/awesome-muse-connectors

    List Airtable bases, read table records, and add records. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~511 tokens
    Auto-check passed
  • Aqara

    Anil-matcha/awesome-muse-connectors

    Read and control Aqara smart home devices: plugs, switches, lights, AC, locks, curtains, scenes.

    1.3k GitHub starsUsed in 1 repo~1.6k tokens
    Auto-check passed
  • Asana

    Anil-matcha/awesome-muse-connectors

    Read and manage Asana tasks: my tasks, task details, create tasks.

    1.3k GitHub starsUsed in 1 repo~481 tokens
    Auto-check passed
  • Attio

    Anil-matcha/awesome-muse-connectors

    Read and write Attio: list objects, query records, upsert records, add notes and tasks.

    1.3k GitHub starsUsed in 1 repo~621 tokens
    Auto-check passed
  • Beatoven

    Anil-matcha/awesome-muse-connectors

    Beatoven.ai royalty-free music generation: compose tracks, poll tasks, download audio, fetch individual stems.

    1.3k GitHub starsUsed in 1 repo~823 tokens
    Auto-check passed
  • Clickup

    Anil-matcha/awesome-muse-connectors

    List ClickUp workspaces and tasks, and create tasks. An agent skill from Anil-matcha/awesome-muse-connectors.

    1.3k GitHub starsUsed in 1 repo~515 tokens
    Auto-check passed

Questions about Newsapi

What does Newsapi do?

Top headlines and full-text news search. An agent skill from Anil-matcha/awesome-muse-connectors. Newsapi is an agent skill from Anil-matcha/awesome-muse-connectors. Top headlines and full-text news search.

How do I install Newsapi in Claude Code?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill newsapi -a claude-code`. Or copy the skill folder (connectors/newsapi in Anil-matcha/awesome-muse-connectors) into .claude/skills/newsapi in your project. Claude Code loads it when a task matches its description.

How do I install Newsapi in Codex?

Run `npx skills add Anil-matcha/awesome-muse-connectors --skill newsapi -a codex`. Or copy the skill folder (connectors/newsapi in Anil-matcha/awesome-muse-connectors) into .agents/skills/newsapi in your project. Codex loads it when a task matches its description.

Can I use Newsapi in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Anil-matcha/awesome-muse-connectors --skill newsapi -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/newsapi, .gemini/skills/newsapi, .github/skills/newsapi and .opencode/skills/newsapi in your project.

What does Newsapi need to run?

Going by SKILL.md and its folder, Newsapi needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Newsapi access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Newsapi safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Newsapi use?

Newsapi is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Newsapi use?

About 501 tokens (SKILL.md is roughly 2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Newsapi?

Skills that share tags, products or a category with Newsapi: Competitor News Monitor (NousResearch/hermes-agent, 252k stars), News (alsk1992/CloddsBot, 2.9k stars), OWASP Top 10 Testing with Strix (usestrix/strix, 67k stars) and News Sentiment Engine (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsapi?

Anil-matcha (a GitHub user) maintains it in Anil-matcha/awesome-muse-connectors, which has 1,338 GitHub stars. The repository holds 153 skills in this directory. The repository was last updated on October 5, 2026.

Source: Anil-matcha/awesome-muse-connectors on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.