Skip to main content
skill CX Codex

minimax-web-search — Claude Code skill: what it does, how to install

minimax-web-search teaches the agent to call web_search for facts that may have moved since training: releases, docs, prices. Useful when a remembered answer is not enough.

MIT 169 installs ★ 15 updated 2026-06-20

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add imsus/pi-extension-minimax-coding-plan-mcp --skill minimax-web-search -a claude-code
Open on GitHub

What minimax-web-search does

The skill works as a routing rule: reach for web_search when a fact could have changed, and skip it when the answer sits in general knowledge or in files the agent can already read. It also spells out query habits that pay off, like naming the product and keeping the phrase to a few keywords.

Calls go to POST {api_host}/v1/coding_plan/search with the query carried in q. Results arrive under organic with a title, link, snippet and date, and related_searches hands the agent follow-up angles when the first attempt misses.

You need a MiniMax coding plan key before the first call. A 1004 response points at the API key or the region, while 2038 means the account still has to clear real-name verification. Neither is fixable from the prompt side.

What it helps with

  • Check what changed in a release that shipped after the model's cutoff
  • Attach a dated link to an official docs page instead of a remembered URL
  • Confirm an older fact still holds before shipping it in code comments
  • Decide when the agent should skip searching and answer from context

Example prompts for the agent

  • Search the web for the Node.js 22 release notes and give me the date
  • Check the official docs to see whether the web_search request body changed
  • Find what people use instead of Docker Desktop right now, with links

How to install minimax-web-search

1Skills CLI (Vercel)

npx skills add imsus/pi-extension-minimax-coding-plan-mcp --skill minimax-web-search -a claude-code

2Manually: put the files in place

~/.claude/skills/minimax-web-search/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/minimax-web-search/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about minimax-web-search

How do I install minimax-web-search in Claude Code?

Run npx skills add imsus/pi-extension-minimax-coding-plan-mcp --skill minimax-web-search -a claude-code. The skill file lands at ~/.claude/skills/minimax-web-search/SKILL.md.

What does minimax-web-search do?

It tells the agent when a web_search call is worth making and how to phrase the query, and it documents the response shape and error codes.

Which errors can a search return?

Status 1004 signals an API key or region problem, and 2038 means real-name verification is still pending. For anything else, the message carries a Trace-Id.

Source text

SKILL.md · MIT
---
name: minimax-web-search
description: Search the web for current information using the web_search tool
---

# MiniMax Web Search Skill

Use this skill when you need to find current, real-time, or authoritative information that may have changed since my knowledge cutoff.

## How to Use

Call the `web_search` tool directly with a query:

```
web_search({ query: "your search query" })
```

## When to Use

Use `web_search` when:

- **Current events**: News, recent developments, latest releases
- **Fact verification**: Checking if information is still accurate
- **Technical updates**: New versions, patches, breaking changes
- **Dynamic content**: Prices, availability, schedules
- **Authoritative sources**: Official documentation, API references

## When NOT to Use

Do NOT use `web_search` when:

- **General knowledge** I likely know (historical facts, basic concepts)
- **Coding help** for common patterns (unless asking about latest practices)
- **Opinion-based questions** without specific recent information needs
- **Files already in context** or accessible via `read` tool

## Usage

```
web_search({
  query: "your search query here"
})
```

## API Details

**Endpoint**: `POST {api_host}/v1/coding_plan/search`

**Request Body**:
```json
{
  "q": "your search query"
}
```

**Response Format**:
```json
{
  "organic": [
    {
      "title": "Result Title",
      "link": "https://example.com",
      "snippet": "Brief description...",
      "date": "2025-01-15"
    }
  ],
  "related_searches": [
    {"query": "related query 1"},
    {"query": "related query 2"}
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
```

## Tips for Better Results

1. **Be specific**: "TypeScript 5.4 new features" vs "TypeScript updates"
2. **Include context**: "React 19 server components vs client components"
3. **Use recent keywords**: "2024" or "2025" when timing matters
4. **Target authoritative sources**: Include product names, official sites
5. **Use 3-5 keywords** for optimal results

## Examples

### Good Queries
- "Node.js 22 new features"
- "Claude Code vs pi coding agent 2025"
- "React 19 release date official"
- "Docker desktop alternatives 2024"
- "TypeScript 5.4 generics tutorial"

### Poor Queries
- "how to use TypeScript" (too general)
- "is Python popular" (opinion, not time-sensitive)
- "help me debug my code" (not a search task)
- "best programming language" (opinion-based)

## Response Format

Results include:
- **Titles** and **URLs** for each result
- **Snippets** with relevant context
- **Dates** when available
- **Related searches** for follow-up queries

You can use the suggestions to refine your search or ask the user which direction they'd like to explore.

## Error Handling

- **Status code 1004**: Authentication error - check API key and region
- **Status code 2038**: Real-name verification required
- **Other errors**: Check Trace-Id in error message for support

© imsus · MIT · imsus/pi-extension-minimax-coding-plan-mcp

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set2

Project sponsors

Companies that keep this analytics open