stepfun-search

分类: 工具与效率 | 上传者: Reuben-Sun | 下载: 0 | 版本: v1.0（最新）

StepFun Search API - 实时网络搜索工具。通过 StepFun API 进行互联网搜索，获取最新信息和研究资源。使用场景：用户说"联网搜索 XXX"、"网络搜索 XXX"、"搜索 XXX" 时触发。Triggers: "联网搜索", "网络搜索", "搜索".

更新日志: Source: GitHub https://github.com/Reuben-Sun/openclaw-stepfun-search-skill

目录结构

当前层级: 根目录

📁 references/
- 📄 api-reference.md 5.1 KB
📁 scripts/
- 📄 stepfun_search.py 5.0 KB
📄 .gitignore 245 B
📄 README.md 3.3 KB
📄 SKILL.md 4.8 KB

SKILL.md

---
name: stepfun-search
description: StepFun Search API - 实时网络搜索工具。通过 StepFun API 进行互联网搜索，获取最新信息和研究资源。使用场景：用户说"联网搜索 XXX"、"网络搜索 XXX"、"搜索 XXX" 时触发。Triggers: "联网搜索", "网络搜索", "搜索".
---

# StepFun Search Skill

基于 StepFun API 的实时网络搜索工具。支持多分类搜索、结果过滤和格式化输出。

## Configuration

API configuration is stored in `~/.openclaw/openclaw.json` using the **skills** format:

```json
{
  "skills": {
    "entries": {
      "stepfun-search": {
        "enabled": true,
        "env": {
          "STEPFUN_API_KEY": "YOUR_API_KEY"
        }
      }
    }
  }
}
```

The API key is loaded from the `STEPFUN_API_KEY` environment variable, which is automatically set by OpenClaw's skill system.

### 📝 Migration Note (2026-03-09)

**Previous configuration (❌ DEPRECATED):**
```json
{
  "tools": {
    "web": {
      "search": {
        "apiKey": "YOUR_API_KEY"
      }
    }
  }
}
```

**New configuration (✅ CURRENT):**
- Moved from `tools.web.search.apiKey` to `skills.entries.stepfun-search.env.STEPFUN_API_KEY`
- Reason: OpenClaw core only supports `tools.web` natively. Custom search APIs are better managed as skills.
- Benefit: Cleaner config, proper skill isolation, easier to manage multiple API keys

### ⚠️ Important Note

**Do NOT use `tools.stepfun` or similar!** Use the **skills** format above for all custom tool APIs.

## Core Features

### 1. Research Search (学术搜索)

Find academic papers, research reports, and technical documentation.

**Category:** `research` (默认)

**Best for:**
- 学术论文 (academic papers)
- 研究报告 (research reports)
- 技术文档 (technical docs)
- 白皮书 (whitepapers)

### 2. Programming Search (编程搜索)

Find code snippets, documentation, and programming solutions.

**Category:** `programming`

**Best for:**
- 代码示例 (code examples)
- 技术文档 (technical docs)
- API 参考 (API reference)
- 教程和指南 (tutorials)

### 3. Business Search (商业搜索)

Find business news, market insights, and company information.

**Category:** `business`

**Best for:**
- 商业新闻 (business news)
- 市场分析 (market analysis)
- 公司信息 (company info)
- 行业报告 (industry reports)

### 4. Government Search (政府搜索)

Find government documents, policies, and official information.

**Category:** `gov`

**Best for:**
- 政府文件 (government docs)
- 政策法规 (policies)
- 官方信息 (official info)

## Usage Examples

### CLI Usage

```bash
# 学术搜索（默认）
python3 scripts/stepfun_search.py "transformer attention mechanism" 5 research json

# 编程搜索
python3 scripts/stepfun_search.py "Python asyncio tutorial" 5 programming json

# 商业搜索
python3 scripts/stepfun_search.py "AI startup funding" 5 business markdown

# 政府搜索
python3 scripts/stepfun_search.py "data privacy regulation" 5 gov text
```

### Output Formats

- **JSON**: Full structured data (default)
- **Markdown**: Formatted for documents and chat
- **Text**: Plain text, no markup

## Search Tips

### ✅ Good Search Queries

- **Specific and clear**: "Stable Diffusion fine-tuning guide"
- **Domain-specific**: Use category parameter (research/programming/business/gov)
- **Keyword-based**: "Python async tutorial" (not "How do I learn Python async?")
- **Combined terms**: "PyTorch image classification" (focused, not broad)

### ❌ Avoid

- **Too broad**: "Image", "Data" (use more specific terms)
- **Full sentences**: Use keywords instead
- **Overly long**: Keep under 200 characters for best results

## Error Handling

Common errors and solutions:

| Error | Solution |
|-------|----------|
| `STEPFUN_API_KEY not set` | Check `~/.openclaw/openclaw.json` skills config |
| `Authorization failed` | Verify API key is valid and active |
| `Timeout (>30s)` | Retry or simplify query |
| `No results found` | Try different keywords or change category |

## Rate Limiting

- **Default quota**: Up to 100 requests/day (free tier)
- **Request timeout**: 30 seconds per request
- **Max results**: 10 per query

## Performance Notes

- First request: 2-5 seconds (API processing)
- Cached results: <100ms (15-minute cache TTL)
- Result quality improves with specific queries

## Integration with OpenClaw

This skill is integrated with OpenClaw's:
- **Natural language triggers** - "联网搜索", "网络搜索"
- **Agent system** - Automatically called via skill dispatcher
- **Context persistence** - Results cached within session
- **Output formatting** - Markdown support for chat display

## Advanced: API Reference

See `references/api-reference.md` for:
- Full API endpoint documentation
- Authentication details
- Request/response schemas
- Error codes and handling

登录后下载/点赞/收藏 ❤ 3 | ★ 0

stepfun-search

目录结构

SKILL.md

举报内容

提示