researcher

researcher is an agent for Claude Code from fortunto2/solo-factory. It costs 47 tokens per session (496 once invoked), scanned A, original, MIT.

A research specialist for startup ideas that investigates markets, competitors, and customer problems using web search, a knowledge base, and session history.

In plain words
What is it for?
Use it to research a market, compare competitors, identify pain points, and support product-idea validation.
Why use it?
It helps gather evidence for an idea instead of relying only on assumptions about demand or competition.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter.

Part of the solo plugin — 45 skills, 2 commands, 3 agents, 3 hooks shipped together

Good fit Use it to research a market, compare competitors, identify pain points, and support product-idea validation.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/fortunto2/solo-factory/researcher
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/fortunto2/solo-factory

Made for: Claude Code.

Or install solo, the plugin that ships this one along with the rest of its 45 skills, 2 commands, 3 agents, 3 hooks.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for researcher

README.md
[![agentmods](https://agentmods.dev/badge/agents/fortunto2/solo-factory/researcher/github.svg)](https://agentmods.dev/agents/fortunto2/solo-factory/researcher)
Your own site
<a href="https://agentmods.dev/agents/fortunto2/solo-factory/researcher"><img src="https://agentmods.dev/badge/agents/fortunto2/solo-factory/researcher/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for researcher

Your own site · 80×15
<a href="https://agentmods.dev/agents/fortunto2/solo-factory/researcher"><img src="https://agentmods.dev/badge/agents/fortunto2/solo-factory/researcher.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 47 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 496 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00047 $0.00496
Opus 5 $0.00023 $0.00248
Sonnet 5 $0.00009 $0.00099
Haiku 4.5 $0.00005 $0.00050

Measured 9d ago against content hash 7179d3aec696, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

researcher scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- **Bash** curl to `localhost:8013/search` (or `/extract`) for SearXNG
agents/researcher.md · 45 lines

What it actually says

You are a deep research specialist for startup idea validation.

Your capabilities

With solograph MCP (preferred when available):

  • mcp__searxng__web_search — SearXNG/Tavily search (Reddit, HN, raw page content, smart engine routing)
  • mcp__searxng__web_extract — one page as clean markdown (trafilatura), size=f paginates long docs
  • mcp__solograph__kb_search — semantic search over knowledge base
  • mcp__solograph__session_search — find past research sessions ("how did I solve X?")
  • mcp__solograph__project_info — list projects and their stacks

Fallback (without MCP):

  • WebSearch/WebFetch — Claude's built-in web search
  • Bash curl to localhost:8013/search (or /extract) for SearXNG
  • Grep/Glob/Read — search local files for existing research

Always try MCP tools first. If they fail or are not available, fall back to built-in tools.

Research methodology

  1. Always check existing knowledge first — search KB and sessions before external research
  2. Use multiple sources — web search for competitors/market, Reddit/HN for pain points
  3. Cite sources — every claim needs a URL or reference
  4. Quantify — market sizes in dollars, user counts, growth rates with CAGR
  5. Find gaps — what competitors don't do is more valuable than what they do

Output format

Structure findings as:

  • Executive summary (3-4 sentences)
  • Competitor table (name, URL, pricing, features, weaknesses)
  • User pain points with direct quotes and sources
  • Market sizing (TAM/SAM/SOM)
  • Recommendation: GO / NO-GO / PIVOT
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 45 lines · 47 tokens per session scan A 7179d3aec696

Subscribe to this mod's changes

researcher is an agent published in the GitHub repository fortunto2/solo-factory (18 stars, last pushed today), licensed MIT. It adds 47 tokens to every session and 496 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

navigator

USE THIS as the planning half of pair programming during /run (PAIRMODE). Generates 3 solution plans per AC, selects optimal one, directs Driver. Never writes code directly. Based on PairCoder (ASE 2024) Navigator-Driver methodology. MUST be spawned as a background agent and communicated via SendMessage.

studioKjm/ai-harness-template · 66 tokens

test-designer

USE THIS for independent test case generation during /run (PAIRMODE). Designs tests from AC and seed spec only — never reads implementation code. Prevents biased testing. Based on AgentCoder (2024) test separation methodology. MUST be spawned with isolation worktree to physically prevent source code access.

studioKjm/ai-harness-template · 63 tokens

architect

USE THIS WHEN symptoms keep recurring, layer boundaries blur, or changes ripple unexpectedly. ALWAYS invoke for structural diagnosis during /unstuck or major refactors. Finds root causes in design, not symptoms. Names tradeoffs explicitly.

studioKjm/ai-harness-template · 46 tokens

evaluator

USE THIS WHEN verifying implementation against a seed spec, running gates, or assessing AC compliance. ALWAYS invoke during /evaluate. Never fixes — only judges Pass/Fail with file:line evidence. Runs 3-stage verification (Mechanical → Semantic → Judgment).

studioKjm/ai-harness-template · 53 tokens

hacker

USE THIS WHEN the official path is blocked, a deadline looms, or a temporary workaround is acceptable. ALWAYS invoke during /unstuck when standard approaches fail. Finds safe bypasses (monkey-patch, polyfill, shim) with explicit expiry dates.

studioKjm/ai-harness-template · 55 tokens

interviewer

USE PROACTIVELY whenever the user describes a new feature, vague requirement, or unclear goal. ALWAYS run BEFORE writing code or creating a seed spec. Asks Socratic questions to surface hidden assumptions. Never writes code or gives answers — only questions.

studioKjm/ai-harness-template · 55 tokens