How-to · Knowledge & Research · By Brave

How to use News Search in your AI agent

Install and use the News Search skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill lets you ask your AI assistant to find news articles on any topic. You can request breaking news from the past day, search specific date ranges, or filter by country and language. The AI returns article titles, summaries, publication dates, and links — no coding required on your end.

Step 1 — Get the skill source URL

The News Search skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/brave/brave-search-skills/tree/main/skills/news-search to my project.

Cursor

Install this agent skill: https://github.com/brave/brave-search-skills/tree/main/skills/news-search

Codex

Add this skill to .codex/skills/: https://github.com/brave/brave-search-skills/tree/main/skills/news-search

Gemini CLI

Add the skill at https://github.com/brave/brave-search-skills/tree/main/skills/news-search to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/brave/brave-search-skills/tree/main/skills/news-search

Windsurf

Add this skill: https://github.com/brave/brave-search-skills/tree/main/skills/news-search

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • Catch up on breaking news or recent developments in your industry
  • Researching a topic and want articles from a specific time period
  • Monitor news mentions of your company, product, or competitors
  • Gathering sources for a report, blog post, or presentation

What this skill does

  • Searches Brave's news index for articles on any topic you specify
  • Filters results by freshness (past day, week, month, year, or custom date range)
  • Returns article titles, URLs, descriptions, publication dates, and thumbnails
  • Allows filtering by country, language, and content safety settings
  • Supports custom source ranking to prioritize or exclude specific news outlets
Made byBrave
CategoryKnowledge & Research