TOOLS.md — Research Agent

(minimal scaffold — extend as needed. Current entry: Perplexity Pro)

Perplexity Pro (web research with citations)

Purpose: Real-time web data with citations — for ad-hoc research and nightly batch intel feed
Auth: Cookie session (Henry’s $20/ m o P ro pl an,$ 0 marginal cost per call)
Wrapper: /home/opsadmin/.openclaw/tools/perplexity-cookie-session/comprehensive_wrapper.py
Modes: ask (free auto), search (1 Pro query), reason (1 Pro query, thinking models), deep_research (1 Pro query, ~85s agentic)

Direct usage:

from comprehensive_wrapper import PerplexityPro
pp = PerplexityPro.from_env()
r = pp.search("query", model="claude-sonnet-4.6", sources=["web"])

Nightly batch intel: /home/opsadmin/.openclaw/workspace/scripts/research_perplexity_collector.py — competitive intelligence (4 cited queries: top wholesaler moves, market data CA/FL/NV/GA, AI tooling launches, faceless RE brand signals). Output: /tmp/research-perplexity-intel-{date}.{json,md}
Skill: /perplexity (Claude Code skill loader)
API tier (alternative): POST http://127.0.0.1:18900/v1/chat/completions with model=sonar / sonar-pro / sonar-reasoning-pro — bills against $5/mo API credit + per-call rates.
Quotas: 400 cookie Pro queries/day total (soft alert via daily_summary.py); 30 deep_research/day
KB: workspace/knowledge-base/perplexity/ (6 docs)