# Bocha Web Search

> Default web search tool using Bocha Web Search API. Use for online lookup, verification, time-sensitive information, and citation-based answers.

- Skill: `modbender/bocha-web-search` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add modbender/bocha-web-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/bocha-web-search/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search, AI & ML
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/bocha-web-search

---


# Bocha Web Search

This skill performs web searches using the Bocha Web Search API.

It is designed to:

- Retrieve up-to-date information
- Verify factual claims
- Provide source-backed answers
- Support citation-based responses

This version avoids shell-specific instructions and system-level file operations to ensure compatibility with secure environments such as ClawHub.

---

## When to Use This Skill

Use this skill whenever the user request:

- Requires information not present in the conversation
- Involves time-sensitive or changing data (news, policies, financial data, releases)
- Requires fact-checking or verification
- Requests links, sources, or citations
- Mentions a specific organization, event, person, or product and asks for factual details

If uncertain whether online lookup is required, perform a search.

---

## API Specification

Endpoint:

POST https://api.bocha.cn/v1/web-search

Headers:

Authorization: Bearer <BOCHA_API_KEY>
Content-Type: application/json

Request body (recommended defaults):

{
"query": "<USER_QUERY>",
"freshness": "noLimit",
"summary": true,
"count": 10
}

Field meanings:

- query: search query string (required)
- freshness: time filter (e.g., noLimit, oneWeek, oneMonth)
- summary: whether to include summarized content
- count: number of returned results (1–50)

---

## Response Structure

Search results are located at:

data.webPages.value[]

Each result typically contains:

- name (title)
- url
- snippet
- summary (original content)
- siteName
- datePublished

---

## Citation Rules (Mandatory)

When generating the final answer:

1. Support factual statements using returned sources.
2. Assign citation numbers in order of appearance: [1], [2], [3]
3. End with a References section.
4. Each reference must include:
   - Title
   - URL
   - Site name (if available)

Example output format:

Answer:

<Your answer with inline citations like [1], [2].>

References

[1] `<title>`
`<url>`
Source: `<siteName>`

[2] `<title>`
`<url>`
Source: `<siteName>`

If no reliable sources are found, respond with:
"No reliable sources found."

---

## Error Handling

Common API error codes:

- 400: Bad request
- 401: Invalid API key
- 403: Insufficient balance
- 429: Rate limit exceeded
- 500: Server error

Use log_id from API responses for debugging if needed.