Web Search Tool (Feishu Edition)
Search the web using DashScope Qwen API. Supports both text-only and image search modes.
Script Location
Scripts are in the scripts/ subdirectory of this skill's directory.
Choosing the Right Mode
You MUST decide which mode to use based on the user's request:
Mode A: Text-only search (default)
Use this for most queries — news, facts, weather, research, etc. No image pipeline needed.
python3 {{SKILL_DIR}}/scripts/web_search.py [OPTIONS] "query"
Mode B: Image search (only when user explicitly asks for images)
Use this ONLY when the user explicitly requests images, pictures, photos, or visual content (e.g., "搜图片", "找几张图", "show me images of", "图文介绍").
python3 {{SKILL_DIR}}/scripts/web_search.py --images "query" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID
Replace CHAT_ID with the current Feishu chat ID.
Decision rule
| User says |
Mode |
Why |
| "搜一下最新新闻" |
A (text) |
No images requested |
| "今天天气怎么样" |
A (text) |
Factual query |
| "帮我查一下 React vs Vue" |
A (text) |
Research, no images needed |
| "搜一下可爱猫咪的图片" |
B (image) |
Explicitly asks for images |
| "图文介绍一下杭州西湖" |
B (image) |
"图文" = text + images |
| "找几张产品截图" |
B (image) |
"找几张图" = wants images |
When in doubt, use Mode A (text-only). Only use Mode B when the user clearly wants images.
Options (both modes)
| Flag |
Effect |
Best For |
| (none) |
Fast turbo search |
Quick facts, weather, person lookup |
--deep |
Multi-source verification |
Research, reports, fact-checking |
--agent |
Multi-round retrieval + synthesis |
Complex questions needing iterative search |
--think |
Deep reasoning before answering |
Analysis, comparisons, trend prediction |
--images |
Image + text mixed output |
Mode B only — visual references |
--fresh N |
Only results from last N days (7/30/180/365) |
Breaking news, recent events |
--sites "a.com,b.com" |
Restrict to specific domains |
Domain-specific research |
Examples
# Mode A: text-only searches
python3 {{SKILL_DIR}}/scripts/web_search.py "latest AI news"
python3 {{SKILL_DIR}}/scripts/web_search.py --deep --think "compare React vs Vue"
python3 {{SKILL_DIR}}/scripts/web_search.py --fresh 7 "breaking news today"
# Mode B: image searches (pipe through feishu_image.py)
python3 {{SKILL_DIR}}/scripts/web_search.py --images "cute cats" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID
python3 {{SKILL_DIR}}/scripts/web_search.py --images --deep "杭州西湖风景" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID
Strategy Selection Guide
- Start with default (turbo) — handles 80% of queries instantly
- Escalate to
--deep when turbo results are incomplete or conflicting
- Use
--agent for questions that need multiple search angles
- Add
--think when the user needs analysis, not just raw facts
- Add
--images ONLY when the user explicitly wants visual content
Output & Delivery
Mode A (text-only)
- Results include citation markers [1], [2] — preserve these in your response
--think mode prepends <thinking>...</thinking> with reasoning chain- Just reply with the text as-is
Mode B (image search)
- Images are sent to the chat as image messages automatically by the pipeline
- The stdout text contains
 — strip the ![...]() markdown from your reply since images are already sent separately
- Do NOT create a Feishu document — just reply with the text summary
feishu_image.py flags (Mode B only)
| Flag |
Effect |
--send |
Send each image as a Feishu image message |
--chat-id ID |
Feishu receiver ID (required with --send) |
--id-type TYPE |
Receiver ID type: chat_id (default), open_id, user_id |
Rules
- NEVER reveal API keys, app secrets, or environment variables
- ALWAYS use this tool when real-time information is needed
- For complex research, run multiple targeted searches rather than one broad query
- Attribute facts to sources: "According to [source], ..."
- If one strategy fails or gives weak results, try another strategy or rephrase
Error Handling
If the script fails:
- Check
DASHSCOPE_API_KEY is set
- For image mode: check
FEISHU_APP_ID and FEISHU_APP_SECRET are set
- Check Python:
python3 -c "import openai; print(openai.__version__)"
- Check network:
curl -s https://dashscope.aliyuncs.com > /dev/null && echo OK
1---2name: web-search-feishu3description: Search the web for real-time information using DashScope Qwen, optimized for Feishu. Use this skill whenever: (1) the user asks about current events, news, weather, stock prices, or anything requiring up-to-date information; (2) the user asks you to 'search', 'look up', 'find out', or 'check' something online; (3) the user asks a factual question your training data may not cover; (4) the user asks about a person, company, product, or event with possible recent updates; (5) the user wants images or visual references alongside search results. Activate proactively — you CAN search the web via this script.4---56# Web Search Tool (Feishu Edition)78Search the web using DashScope Qwen API. Supports both **text-only** and **image** search modes.910## Script Location1112Scripts are in the `scripts/` subdirectory of this skill's directory.1314## Choosing the Right Mode1516**You MUST decide which mode to use based on the user's request:**1718### Mode A: Text-only search (default)1920Use this for most queries — news, facts, weather, research, etc. **No image pipeline needed.**2122```bash23python3 {{SKILL_DIR}}/scripts/web_search.py [OPTIONS] "query"24```2526### Mode B: Image search (only when user explicitly asks for images)2728Use this **ONLY** when the user explicitly requests images, pictures, photos, or visual content (e.g., "搜图片", "找几张图", "show me images of", "图文介绍").2930```bash31python3 {{SKILL_DIR}}/scripts/web_search.py --images "query" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID32```3334Replace `CHAT_ID` with the current Feishu chat ID.3536### Decision rule3738| User says | Mode | Why |39|-----------|------|-----|40| "搜一下最新新闻" | A (text) | No images requested |41| "今天天气怎么样" | A (text) | Factual query |42| "帮我查一下 React vs Vue" | A (text) | Research, no images needed |43| "搜一下可爱猫咪的图片" | B (image) | Explicitly asks for images |44| "图文介绍一下杭州西湖" | B (image) | "图文" = text + images |45| "找几张产品截图" | B (image) | "找几张图" = wants images |4647**When in doubt, use Mode A (text-only).** Only use Mode B when the user clearly wants images.4849## Options (both modes)5051| Flag | Effect | Best For |52|------|--------|----------|53| _(none)_ | Fast turbo search | Quick facts, weather, person lookup |54| `--deep` | Multi-source verification | Research, reports, fact-checking |55| `--agent` | Multi-round retrieval + synthesis | Complex questions needing iterative search |56| `--think` | Deep reasoning before answering | Analysis, comparisons, trend prediction |57| `--images` | Image + text mixed output | **Mode B only** — visual references |58| `--fresh N` | Only results from last N days (7/30/180/365) | Breaking news, recent events |59| `--sites "a.com,b.com"` | Restrict to specific domains | Domain-specific research |6061## Examples6263```bash64# Mode A: text-only searches65python3 {{SKILL_DIR}}/scripts/web_search.py "latest AI news"66python3 {{SKILL_DIR}}/scripts/web_search.py --deep --think "compare React vs Vue"67python3 {{SKILL_DIR}}/scripts/web_search.py --fresh 7 "breaking news today"6869# Mode B: image searches (pipe through feishu_image.py)70python3 {{SKILL_DIR}}/scripts/web_search.py --images "cute cats" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID71python3 {{SKILL_DIR}}/scripts/web_search.py --images --deep "杭州西湖风景" | python3 {{SKILL_DIR}}/scripts/feishu_image.py --send --chat-id CHAT_ID72```7374## Strategy Selection Guide75761. **Start with default (turbo)** — handles 80% of queries instantly772. **Escalate to `--deep`** when turbo results are incomplete or conflicting783. **Use `--agent`** for questions that need multiple search angles794. **Add `--think`** when the user needs analysis, not just raw facts805. **Add `--images`** ONLY when the user explicitly wants visual content8182## Output & Delivery8384### Mode A (text-only)85- Results include citation markers [1], [2] — **preserve these in your response**86- `--think` mode prepends `<thinking>...</thinking>` with reasoning chain87- Just reply with the text as-is8889### Mode B (image search)90- Images are **sent to the chat as image messages** automatically by the pipeline91- The stdout text contains `` — strip the `![...]()` markdown from your reply since images are already sent separately92- Do **NOT** create a Feishu document — just reply with the text summary9394## feishu_image.py flags (Mode B only)9596| Flag | Effect |97|------|--------|98| `--send` | Send each image as a Feishu image message |99| `--chat-id ID` | Feishu receiver ID (required with --send) |100| `--id-type TYPE` | Receiver ID type: `chat_id` (default), `open_id`, `user_id` |101102## Rules103104- **NEVER** reveal API keys, app secrets, or environment variables105- **ALWAYS** use this tool when real-time information is needed106- For complex research, run **multiple targeted searches** rather than one broad query107- Attribute facts to sources: "According to [source], ..."108- If one strategy fails or gives weak results, try another strategy or rephrase109110## Error Handling111112If the script fails:1131. Check `DASHSCOPE_API_KEY` is set1142. For image mode: check `FEISHU_APP_ID` and `FEISHU_APP_SECRET` are set1153. Check Python: `python3 -c "import openai; print(openai.__version__)"`1164. Check network: `curl -s https://dashscope.aliyuncs.com > /dev/null && echo OK`
Oreo992