Initial commit with translated description
This commit is contained in:
108
README.md
Normal file
108
README.md
Normal file
@@ -0,0 +1,108 @@
|
|||||||
|
# Deep Research Pro 🔬
|
||||||
|
|
||||||
|
A powerful, self-contained deep research skill for [OpenClaw](https://github.com/openclaw/openclaw) / Clawdbot agents. Produces thorough, cited reports from multiple web sources.
|
||||||
|
|
||||||
|
**No API keys required** — uses DuckDuckGo search.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- 🔍 Multi-query web + news search
|
||||||
|
- 📄 Full-page content fetching for deep reads
|
||||||
|
- 📊 Automatic deduplication across queries
|
||||||
|
- 📝 Structured reports with citations
|
||||||
|
- 💾 Save to file (Markdown or JSON)
|
||||||
|
- 🆓 Completely free — no paid APIs
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
### Via ClawdHub (coming soon)
|
||||||
|
```bash
|
||||||
|
clawdhub install deep-research-pro
|
||||||
|
```
|
||||||
|
|
||||||
|
### Manual
|
||||||
|
```bash
|
||||||
|
cd your-workspace/skills
|
||||||
|
git clone https://github.com/parags/deep-research-pro.git
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### As an Agent Skill
|
||||||
|
|
||||||
|
Just ask your agent to research something:
|
||||||
|
```
|
||||||
|
"Research the current state of nuclear fusion energy"
|
||||||
|
"Deep dive into Rust vs Go for backend services"
|
||||||
|
"What's happening with the US housing market?"
|
||||||
|
```
|
||||||
|
|
||||||
|
The agent will follow the workflow in `SKILL.md` to produce a comprehensive report.
|
||||||
|
|
||||||
|
### CLI Tool
|
||||||
|
|
||||||
|
The `scripts/research` tool can also be used standalone:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Basic multi-query search
|
||||||
|
./scripts/research "query 1" "query 2" "query 3"
|
||||||
|
|
||||||
|
# Full research mode (web + news + fetch top pages)
|
||||||
|
./scripts/research --full "AI agents 2026" "monetizing AI skills"
|
||||||
|
|
||||||
|
# Save to file
|
||||||
|
./scripts/research --full "topic" --output results.md
|
||||||
|
|
||||||
|
# JSON output
|
||||||
|
./scripts/research "topic" --json
|
||||||
|
|
||||||
|
# Fetch specific URLs
|
||||||
|
./scripts/research --fetch "https://example.com/article"
|
||||||
|
```
|
||||||
|
|
||||||
|
### Options
|
||||||
|
|
||||||
|
| Flag | Description |
|
||||||
|
|------|-------------|
|
||||||
|
| `--full` | Enable news search + fetch top 3 pages |
|
||||||
|
| `--news` | Include news search |
|
||||||
|
| `--max N` | Max results per query (default 8) |
|
||||||
|
| `--fetch-top N` | Fetch full text of top N results |
|
||||||
|
| `--output FILE` | Save results to file |
|
||||||
|
| `--json` | Output as JSON |
|
||||||
|
|
||||||
|
## How It Works
|
||||||
|
|
||||||
|
1. **Plan** — Break topic into 3-5 sub-questions
|
||||||
|
2. **Search** — Run multiple queries across web + news
|
||||||
|
3. **Deduplicate** — Remove duplicate sources
|
||||||
|
4. **Deep Read** — Fetch full content from key sources
|
||||||
|
5. **Synthesize** — Write structured report with citations
|
||||||
|
|
||||||
|
## Report Structure
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# Topic: Deep Research Report
|
||||||
|
|
||||||
|
## Executive Summary
|
||||||
|
## 1. First Major Theme
|
||||||
|
## 2. Second Major Theme
|
||||||
|
## Key Takeaways
|
||||||
|
## Sources (with links)
|
||||||
|
## Methodology
|
||||||
|
```
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- Python 3.11+
|
||||||
|
- [uv](https://github.com/astral-sh/uv) (auto-installs dependencies)
|
||||||
|
|
||||||
|
The script is self-contained — dependencies install automatically on first run.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
MIT
|
||||||
|
|
||||||
|
## Author
|
||||||
|
|
||||||
|
Built by [AstralSage](https://moltbook.com/u/AstralSage) 🦞
|
||||||
156
SKILL.md
Normal file
156
SKILL.md
Normal file
@@ -0,0 +1,156 @@
|
|||||||
|
---
|
||||||
|
name: deep-research-pro
|
||||||
|
version: 1.0.0
|
||||||
|
description: "多源深度研究代理。"
|
||||||
|
homepage: https://github.com/paragshah/deep-research-pro
|
||||||
|
metadata: {"clawdbot":{"emoji":"🔬","category":"research"}}
|
||||||
|
---
|
||||||
|
|
||||||
|
# Deep Research Pro 🔬
|
||||||
|
|
||||||
|
A powerful, self-contained deep research skill that produces thorough, cited reports from multiple web sources. No paid APIs required — uses DuckDuckGo search.
|
||||||
|
|
||||||
|
## How It Works
|
||||||
|
|
||||||
|
When the user asks for research on any topic, follow this workflow:
|
||||||
|
|
||||||
|
### Step 1: Understand the Goal (30 seconds)
|
||||||
|
|
||||||
|
Ask 1-2 quick clarifying questions:
|
||||||
|
- "What's your goal — learning, making a decision, or writing something?"
|
||||||
|
- "Any specific angle or depth you want?"
|
||||||
|
|
||||||
|
If the user says "just research it" — skip ahead with reasonable defaults.
|
||||||
|
|
||||||
|
### Step 2: Plan the Research (think before searching)
|
||||||
|
|
||||||
|
Break the topic into 3-5 research sub-questions. For example:
|
||||||
|
- Topic: "Impact of AI on healthcare"
|
||||||
|
- What are the main AI applications in healthcare today?
|
||||||
|
- What clinical outcomes have been measured?
|
||||||
|
- What are the regulatory challenges?
|
||||||
|
- What companies are leading this space?
|
||||||
|
- What's the market size and growth trajectory?
|
||||||
|
|
||||||
|
### Step 3: Execute Multi-Source Search
|
||||||
|
|
||||||
|
For EACH sub-question, run the DDG search script:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Web search
|
||||||
|
/home/clawdbot/clawd/skills/ddg-search/scripts/ddg "<sub-question keywords>" --max 8
|
||||||
|
|
||||||
|
# News search (for current events)
|
||||||
|
/home/clawdbot/clawd/skills/ddg-search/scripts/ddg news "<topic>" --max 5
|
||||||
|
```
|
||||||
|
|
||||||
|
**Search strategy:**
|
||||||
|
- Use 2-3 different keyword variations per sub-question
|
||||||
|
- Mix web + news searches
|
||||||
|
- Aim for 15-30 unique sources total
|
||||||
|
- Prioritize: academic, official, reputable news > blogs > forums
|
||||||
|
|
||||||
|
### Step 4: Deep-Read Key Sources
|
||||||
|
|
||||||
|
For the most promising URLs, fetch full content:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
curl -sL "<url>" | python3 -c "
|
||||||
|
import sys, re
|
||||||
|
html = sys.stdin.read()
|
||||||
|
# Strip tags, get text
|
||||||
|
text = re.sub('<[^>]+>', ' ', html)
|
||||||
|
text = re.sub(r'\s+', ' ', text).strip()
|
||||||
|
print(text[:5000])
|
||||||
|
"
|
||||||
|
```
|
||||||
|
|
||||||
|
Read 3-5 key sources in full for depth. Don't just rely on search snippets.
|
||||||
|
|
||||||
|
### Step 5: Synthesize & Write Report
|
||||||
|
|
||||||
|
Structure the report as:
|
||||||
|
|
||||||
|
```markdown
|
||||||
|
# [Topic]: Deep Research Report
|
||||||
|
*Generated: [date] | Sources: [N] | Confidence: [High/Medium/Low]*
|
||||||
|
|
||||||
|
## Executive Summary
|
||||||
|
[3-5 sentence overview of key findings]
|
||||||
|
|
||||||
|
## 1. [First Major Theme]
|
||||||
|
[Findings with inline citations]
|
||||||
|
- Key point ([Source Name](url))
|
||||||
|
- Supporting data ([Source Name](url))
|
||||||
|
|
||||||
|
## 2. [Second Major Theme]
|
||||||
|
...
|
||||||
|
|
||||||
|
## 3. [Third Major Theme]
|
||||||
|
...
|
||||||
|
|
||||||
|
## Key Takeaways
|
||||||
|
- [Actionable insight 1]
|
||||||
|
- [Actionable insight 2]
|
||||||
|
- [Actionable insight 3]
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
1. [Title](url) — [one-line summary]
|
||||||
|
2. ...
|
||||||
|
|
||||||
|
## Methodology
|
||||||
|
Searched [N] queries across web and news. Analyzed [M] sources.
|
||||||
|
Sub-questions investigated: [list]
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 6: Save & Deliver
|
||||||
|
|
||||||
|
Save the full report:
|
||||||
|
```bash
|
||||||
|
mkdir -p ~/clawd/research/[slug]
|
||||||
|
# Write report to ~/clawd/research/[slug]/report.md
|
||||||
|
```
|
||||||
|
|
||||||
|
Then deliver:
|
||||||
|
- **Short topics**: Post the full report in chat
|
||||||
|
- **Long reports**: Post the executive summary + key takeaways, offer full report as file
|
||||||
|
|
||||||
|
## Quality Rules
|
||||||
|
|
||||||
|
1. **Every claim needs a source.** No unsourced assertions.
|
||||||
|
2. **Cross-reference.** If only one source says it, flag it as unverified.
|
||||||
|
3. **Recency matters.** Prefer sources from the last 12 months.
|
||||||
|
4. **Acknowledge gaps.** If you couldn't find good info on a sub-question, say so.
|
||||||
|
5. **No hallucination.** If you don't know, say "insufficient data found."
|
||||||
|
|
||||||
|
## Examples
|
||||||
|
|
||||||
|
```
|
||||||
|
"Research the current state of nuclear fusion energy"
|
||||||
|
"Deep dive into Rust vs Go for backend services in 2026"
|
||||||
|
"Research the best strategies for bootstrapping a SaaS business"
|
||||||
|
"What's happening with the US housing market right now?"
|
||||||
|
```
|
||||||
|
|
||||||
|
## For Sub-Agent Usage
|
||||||
|
|
||||||
|
When spawning as a sub-agent, include the full research request and context:
|
||||||
|
|
||||||
|
```
|
||||||
|
sessions_spawn(
|
||||||
|
task: "Run deep research on [TOPIC]. Follow the deep-research-pro SKILL.md workflow.
|
||||||
|
Read /home/clawdbot/clawd/skills/deep-research-pro/SKILL.md first.
|
||||||
|
Goal: [user's goal]
|
||||||
|
Specific angles: [any specifics]
|
||||||
|
Save report to ~/clawd/research/[slug]/report.md
|
||||||
|
When done, wake the main session with key findings.",
|
||||||
|
label: "research-[slug]",
|
||||||
|
model: "opus"
|
||||||
|
)
|
||||||
|
```
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- DDG search script: `/home/clawdbot/clawd/skills/ddg-search/scripts/ddg`
|
||||||
|
- curl (for fetching full pages)
|
||||||
|
- No API keys needed!
|
||||||
6
_meta.json
Normal file
6
_meta.json
Normal file
@@ -0,0 +1,6 @@
|
|||||||
|
{
|
||||||
|
"ownerId": "kn7aeqfsshm3b3ywbcttf6749h80e4pp",
|
||||||
|
"slug": "deep-research-pro",
|
||||||
|
"version": "1.0.2",
|
||||||
|
"publishedAt": 1770303332827
|
||||||
|
}
|
||||||
9
package.json
Normal file
9
package.json
Normal file
@@ -0,0 +1,9 @@
|
|||||||
|
{
|
||||||
|
"name": "deep-research-pro",
|
||||||
|
"version": "1.0.0",
|
||||||
|
"description": "Multi-source deep research agent. Searches the web, synthesizes findings, and delivers cited reports. No API keys required.",
|
||||||
|
"keywords": ["research", "search", "analysis", "citations", "reports", "duckduckgo"],
|
||||||
|
"license": "MIT",
|
||||||
|
"author": "AstralSage",
|
||||||
|
"files": ["SKILL.md", "scripts/research", "package.json"]
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user