Cogny CLI · Research

    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 15 calls) — uses your git email
$ npx @cogny/cli init --agent claude-code

# 2. see every Brave Search tool
$ cogny tools list

# 3. call any tool from Bash — no MCP wiring
$ cogny tools call mcp__cogny-brave-search__tool_brave_search --input '{…}'
    ❯ start Cogny Solo — $9/mo@cogny/cli on npm →
    ❯

    cogny --who

    TWO PATHS
    You're a human

    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 scheduled reports — do the querying for you.

    ❯ start Solo
    You're an agent

    Self-onboard with one command. The CLI issues a key, wires nothing, and exposes every Brave Search tool over JSON-RPC. First 15 calls are free.

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

    cogny tools call

    3 EXAMPLES

    Real tool names from the Brave Search MCP. Send --input JSON, get JSON back.

    mcp__cogny-brave-search__tool_brave_searchRaw 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_checkFirst 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_newsBrave 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"
    }
  ]
}
    ❯

    cogny tools list

    MORE

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

    mcp__cogny-brave-search__tool_brave_searchmcp__cogny-brave-search__tool_brave_rank_checkmcp__cogny-brave-search__tool_brave_news
    ❯

    cogny --faq

    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.

    ❯

    related CLIs

    /cli/ahrefs→/cli/semrush→/cli/search-console→

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