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

When in doubt, use Mode A (text-only). Only use Mode B when the user clearly wants images.

Options (both modes)

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

1. Start with default (turbo) — handles 80% of queries instantly
2. Escalate to --deep when turbo results are incomplete or conflicting
3. Use --agent for questions that need multiple search angles
4. Add --think when the user needs analysis, not just raw facts
5. 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 ... 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 !alt — 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)

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:

1. Check DASHSCOPE_API_KEY is set
2. For image mode: check FEISHU_APP_ID and FEISHU_APP_SECRET are set
3. Check Python: python3 -c "import openai; print(openai.__version__)"
4. Check network: curl -s https://dashscope.aliyuncs.com > /dev/null && echo OK