sofya-research
Get a cited research report from many web sources in one call with Sofya research. Use when the user asks to research a topic, compare options, survey a field or answer a question that one search won't settle, for example "research", "deep dive", "compare", "what are the options for".
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- sofya-research
- metadata
- { "openclaw": { "envVars": [ { "name": "SOFYA_API_KEY", "required": true, "description": "Sofya API key (sofya.co/dashboard). Not needed when the Sofya MCP server is connected." } ], "homepage": "https://sofya.co/docs", "requires": { "env": [ "SOFYA_API_KEY" ], "bins": [ "curl" ] }, "primaryEnv": "SOFYA_API_KEY" } }
- description
- Get a cited research report from many web sources in one call with Sofya research. Use when the user asks to research a topic, compare options, survey a field or answer a question that one search won't settle, for example "research", "deep dive", "compare", "what are the options for".
03 SKILL.md 正文
Sofya research
research breaks a question into several searches, reads the sources in parallel and writes a structured report with citations. One call costs 50 credits and usually takes 20-60 seconds.
Use it for open-ended questions. For a quick fact, a single page or a known URL, the sofya-search skill is cheaper and faster.
How to call it
- MCP tool available (
researchfrom a server namedsofya): call it directly. - No MCP tool,
SOFYA_API_KEYis set: use curl. Set the timeout to at least 90 seconds. - Neither: tell the user Sofya needs a key (https://sofya.co/dashboard, or have them approve one via https://sofya.co/auth.md).
Parameters: query (required), topic (general | news), freshness (day, week, month, year, or YYYY-MM-DD:YYYY-MM-DD), max_sources (5-30, default 20).
curl -s --max-time 120 -X POST https://sofya.co/v1/research \
-H "Authorization: Bearer $SOFYA_API_KEY" -H "Content-Type: application/json" \
-d '{"query": "how do heat pumps perform in cold climates", "max_sources": 15}'
Response: report (markdown with numbered citations), sources[] with title, url, published_date, sub_queries (the searches it ran), credits_used, credits_remaining.
Steps
- Sharpen the question first. Put the scope in the query: the time range, region, audience or the criteria to compare on. "Compare managed Postgres hosts for a small team on price, backups and EU regions" gets a far better report than "best Postgres hosting".
- Recent topics: compute dates from today's date and pass
freshness, or usetopic: "news". - One call per question. Don't call research repeatedly with reworded queries. If the report leaves a gap, fill it with a targeted
searchorfetchinstead. - Check before you rely on it. For numbers or claims the user will act on,
fetchthe cited source and confirm. - Deliver: summarise the report for the user, keep the citations, and list the source URLs.
Errors
Only successful responses are charged; a failed or timed-out call is refunded, so retrying is safe. 402 means out of credits: give the user the top_up_url (or with MCP, a link from buy_credits). 429: wait Retry-After seconds. 502/503: retry once shortly after.
Full reference: https://sofya.co/docs#research
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.