# Web Search

> Search the web through the scoped Brave integration. Call this tool directly; never invoke web-search through bash.

- Skill: `tashfeenahmed/web-search` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add tashfeenahmed/web-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tashfeenahmed/web-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tashfeenahmed (https://skillmd.com/u/tashfeenahmed)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/tashfeenahmed/web-search

---


# Web Search Skill

Call `web_search` directly. Its scoped subprocess receives the Brave credential;
generic bash intentionally does not.

Example: `{ "query": "TypeScript tutorial", "count": 10 }`

## Quick Reference

```json
{"query":"React hooks tutorial","count":10}
{"query":"AI news","count":10,"freshness":"pd"}
```

## When to Use

Use `web_search` for:
- **Current events**: News, sports scores, recent developments
- **Research**: Looking up people, companies, products, technologies
- **Documentation**: Finding tutorials, API docs, code examples
- **Fact-checking**: Verifying information, getting authoritative sources
- **General knowledge**: Any question about the real world

## Output Format

Results are formatted as:
```
Search results for "query":

1. Title (age)
   https://example.com/url
   Description of the result...

2. Another Title (2 days ago)
   https://example.com/another
   Another description...
```

News results are prefixed with `[NEWS]` in the title.

## Tips

1. Use `freshness: "pd"` for breaking news.
2. Increase `count` for research tasks, up to 20.
3. Be specific in queries for better results.
4. Open primary result pages with `webfetch` before making factual claims.

## Environment

Requires `BRAVE_SEARCH_API_KEY` environment variable.
Get your API key from: https://api.search.brave.com/