---
name: bailian-search-71fdfed96e63
description: "Real-time web search powered by Alibaba Cloud Bailian (DashScope) MCP service. Use when: user asks for latest news, real-time information, current events, or facts that may have changed recently. Requires: DASHSCOPE_API_KEY environment variable."
homepage: https://bailian.console.aliyun.com
metadata:
  {
    "openclaw":
      {
        "emoji": "🔍",
        "requires": { "bins": ["curl", "python3"], "env": ["DASHSCOPE_API_KEY"] },
      },
  }
---

# Bailian Search

Real-time web search powered by Alibaba Cloud Bailian (DashScope) MCP service.

## Overview

This skill integrates with Alibaba Cloud Bailian's Web Search MCP (Model Context Protocol) service, enabling AI assistants to retrieve real-time information from the internet, improving response accuracy and timeliness.

## Features

- 🔍 Real-time web search
- 🌐 Global information coverage
- ⚡ Fast response via SSE (Server-Sent Events)
- 🔒 Secure API key management
- 🛠️ Easy integration with OpenClaw

## Prerequisites

1. **Alibaba Cloud Account**: Register at [Alibaba Cloud Bailian](https://bailian.console.aliyun.com)
2. **API Key**: Obtain a DashScope API Key from the console

## Installation

### Using ClawHub (Recommended)

```bash
openclaw skill install bailian-search
# or
clawhub install bailian-search
```

### Manual Installation

```bash
# Clone to OpenClaw workspace
git clone <repository-url> ~/.openclaw/workspace/skills/bailian-search

# Or download and extract to:
# ~/.openclaw/workspace/skills/bailian-search/
```

## Configuration

### Set Environment Variable

**Option 1: Temporary (current session)**
```bash
export DASHSCOPE_API_KEY="your-dashscope-api-key"
```

**Option 2: Permanent (recommended)**

Add to your shell profile (`~/.zshrc` or `~/.bashrc`):
```bash
echo 'export DASHSCOPE_API_KEY="your-dashscope-api-key"' >> ~/.zshrc
source ~/.zshrc
```

**Option 3: OpenClaw Config**
```bash
openclaw config set env.DASHSCOPE_API_KEY "your-dashscope-api-key"
```

## Usage

### Command Line

```bash
# After setting environment variable
./search.sh "latest tech news"

# Or one-liner
DASHSCOPE_API_KEY="your-key" ./search.sh "OpenAI GPT-5 release"
```

### Via AI Assistant

Once configured, simply ask your AI assistant:
- "Search for today's tech news"
- "Find OpenAI's latest announcements"
- "Look up 2025 China EV sales data"

The AI will automatically use this skill to fetch real-time information.

## How It Works

This skill connects to Alibaba Cloud Bailian's **MCP SSE (Server-Sent Events)** service:

1. Receives user search query
2. Establishes SSE connection to Bailian MCP server
3. Retrieves real-time search results
4. Returns structured content to the AI

## MCP Configuration (Advanced)

For use with other MCP-compatible clients (Claude Desktop, Cursor, etc.):

```json
{
  "mcpServers": {
    "WebSearch": {
      "type": "sse",
      "name": "Alibaba Cloud Bailian Web Search",
      "description": "Real-time web search powered by Tongyi Lab's Text-Embedding, GTE-reRank, Query Rewriting, and Search Judgment models.",
      "baseUrl": "https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/sse",
      "headers": {
        "Authorization": "Bearer ${DASHSCOPE_API_KEY}"
      }
    }
  }
}
```

## API Reference

### Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `DASHSCOPE_API_KEY` | Yes | Alibaba Cloud DashScope API Key |

### Command Arguments

```bash
./search.sh <query>
```

| Argument | Type | Required | Description |
|----------|------|----------|-------------|
| `query` | string | Yes | Search query string |

## Troubleshooting

**Error: "DASHSCOPE_API_KEY environment variable is not set"**

Solution: Ensure the environment variable is set:
```bash
export DASHSCOPE_API_KEY="your-key"
```

**Empty results or timeout**

1. Verify your API key is valid
2. Check network connectivity
3. Bailian service may take time to respond, please be patient

**How to get DashScope API Key?**

1. Visit [Alibaba Cloud Bailian Console](https://bailian.console.aliyun.com)
2. Register/login with Alibaba Cloud account
3. Create an API Key in the console
4. Copy the key and set it as environment variable

## Privacy & Security

- Your API key is never hardcoded in the skill files
- API key is read from environment variables only
- No data is stored or logged by this skill
- All requests go directly to Alibaba Cloud servers

## License

MIT License - See LICENSE file for details

## Contributing

Contributions are welcome! Please submit issues or pull requests via ClawHub.

## Acknowledgments

- Alibaba Cloud Bailian (DashScope) for providing the MCP service
- OpenClaw team for the skill framework
- MCP community for the protocol specification

## Links

- [Alibaba Cloud Bailian](https://bailian.console.aliyun.com)
- [DashScope Documentation](https://help.aliyun.com/document_detail/611474.html)
- [OpenClaw Documentation](https://docs.openclaw.ai)
- [ClawHub Registry](https://clawhub.com)

---
Source attribution: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/bailian-search/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2025 skill-library-mcp contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: modbender
Original project: https://github.com/modbender/skill-library-mcp/blob/d9c8fe903b5b4e82237dbe8d0df8567783022e18/data/bailian-search/SKILL.md
Attribution basis: Source repository record

Fields of work: Data & Analytics, Marketing, Product Management
Roles: Data Analyst, Marketing Analyst, Product Manager
Specialties: API
Tools: Alibaba Cloud
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: fdb384ff1def39e3911fb62274f69a7897c3ac55c53d16ce68290d258725cd05