cogny cliresearchfirst 15 calls free

brave search from your terminal.

Search the web and news, and rank-check any domain, against Brave Search — the independent ~40B-page index that powers Claude.ai web search — from Bash over the Brave Search MCP. The cleanest read on AI / generative-search (AEO/GEO) visibility.

1. sign up, free for the first calls (uses your git email)npx @cogny/cli init --agent claude-code
2. see every Brave Search toolcogny tools list
3. call any tool from bash, no MCP wiringcogny tools call mcp__cogny-brave-search__tool_brave_search --input '{…}'

Start free @cogny/cli on npm

01two paths

you're a person

Tracking where you show up in AI search means opening a browser, typing the query, and counting positions by eye. The CLI returns the SERP and your exact rank as JSON in one call — schedulable, diffable, no manual scrolling. Connect Brave Search once in Cogny Solo and let your coding agent, or a scheduled loop, do the querying for you.

Start Solo

you're an agent

Sign yourself up with one command. The CLI issues a key, wires nothing, and exposes every Brave Search tool over JSON-RPC. The first 15 calls are free.

npx @cogny/cli init --agent claude-code

02tools call

real Brave Search tools.

Tool names as the Brave Search MCP serves them. Send --input JSON, get JSON back. The payloads are illustrative.

mcp__cogny-brave-search__tool_brave_search

Raw web SERP for a query as a slim JSON list.

cogny tools call mcp__cogny-brave-search__tool_brave_search \ --input '{"query":"best running shoes 2026","count":3,"country":"US"}'

example response

{
  "results": [
    {
      "title": "The Best Running Shoes of 2026",
      "url": "https://runnersworld.com/best",
      "description": "Our tested picks…",
      "age": "2026-05-10"
    },
    {
      "title": "Best Running Shoes — Wirecutter",
      "url": "https://nytimes.com/wirecutter/shoes",
      "description": "After 60 hours of testing…",
      "age": "2026-04-22"
    },
    {
      "title": "Top Trail Running Shoes",
      "url": "https://example.com/best",
      "description": "Trail and road picks…",
      "age": "2026-06-01"
    }
  ],
  "count_returned": 3
}

mcp__cogny-brave-search__tool_brave_rank_check
First position of a domain in Brave SERP for a keyword.
- cogny tools call mcp__cogny-brave-search__tool_brave_rank_check \ --input '{"domain":"example.com","query":"best running shoes 2026","country":"US"}'
example response
```
{
  "found": true,
  "position": 3,
  "matched_result": {
    "title": "Top Trail Running Shoes",
    "url": "https://example.com/best"
  },
  "searched_count": 30
}
```

mcp__cogny-brave-search__tool_brave_news

Brave News search for PR and trend monitoring.

cogny tools call mcp__cogny-brave-search__tool_brave_news \ --input '{"query":"running shoe recall","count":2,"freshness":"pw"}'

example response

{
  "results": [
    {
      "title": "Brand X recalls trail model over sole defect",
      "url": "https://reuters.com/x-recall",
      "source": "Reuters",
      "age": "2 days ago"
    },
    {
      "title": "Runners react to recall news",
      "url": "https://runnersworld.com/recall",
      "source": "Runner's World",
      "age": "4 days ago"
    }
  ]
}

03tools list

the rest of the surface.

A sample of the other Brave Search tools. Run cogny tools list --json for every tool and its input schema.

mcp__cogny-brave-search__tool_brave_search
mcp__cogny-brave-search__tool_brave_rank_check
mcp__cogny-brave-search__tool_brave_news

04then a verdict

calls from a script. verdicts from cogny.

Every write is logged with who authorised it. Launches your agent makes (a new campaign, a new ad) become measured tickets automatically; for other changes, your agent offers to register them. Cogny measures each in your own data, three days later for ads and seven for content and SEO, and closes it as worked, partial, didn't work or inconclusive.

worked
Moved the number. Every measured win has a share card.
partial
Some of it did.
didn't work
On the record anyway, so it isn't proposed again.
inconclusive
Not enough data to call.

How the loop works

05questions

questions.

Is this an official Brave CLI?: No — it is the Cogny CLI calling the Brave Search MCP over the cogny-mcp-proxy. Brave Search is included as a built-in on Cogny, so there is no API key to manage; calls are metered through the Cogny credit system.
Why Brave for AI-search visibility?: Brave runs its own independent ~40B-page index and is the engine behind Claude.ai web search, so its SERP is a clean proxy for how AI assistants see your site — making it well-suited for AEO/GEO rank tracking.
Does each call cost a credit?: Yes — each tool call debits one credit from your warehouse balance (then top-up balance). A rank-check may page through several Brave API calls internally but still counts as a single tool call.

06related

Building an agent? The full tool map for every server is one fetch: /cli/llms.txt

brave search, then a verdict.

Start free All CLIs