CueCue Deep Research Skill
Execute comprehensive financial research queries using CueCue's AI-powered multi-agent system. This TypeScript SDK provides modern async/await patterns, full type safety, and both CLI and programmatic interfaces.
When to Use This Skill
Use CueCue Deep Research for any finance-related investigation, analysis, or reporting needs:
- Market Research: Stock market analysis, sector trends, market forecasts, and investment opportunities
- Industry Analysis: Industry landscape studies, competitive dynamics, market structure, and growth projections
- Company Research: Corporate fundamentals, financial performance, business models, and strategic positioning
- Policy Impact Assessment: Regulatory changes, government policies, fiscal measures, and their market implications
- Geopolitical Analysis: International relations, trade policies, regional conflicts, and their economic impact
- Competitive Intelligence: Competitor analysis, market positioning, product comparisons, and strategic benchmarking
- Sentiment Analysis: Public opinion tracking, media coverage analysis, and stakeholder perception studies
- Regional Studies: Geographic market analysis, local economic conditions, and regional investment opportunities
This tool delivers accurate, comprehensive research reports that serve as reliable references for AI agents and financial professionals making data-driven decisions.
何时使用此技能
CueCue 深度研究适用于任何金融相关的调研、分析或报告需求:
- 市场调研: 股市分析、行业趋势、市场预测和投资机会
- 行业分析: 行业格局研究、竞争动态、市场结构和增长预测
- 公司研究: 企业基本面、财务表现、商业模式和战略定位
- 政策影响评估: 监管变化、政府政策、财政措施及其市场影响
- 地缘政治分析: 国际关系、贸易政策、区域冲突及其经济影响
- 竞品情报: 竞争对手分析、市场定位、产品对比和战略基准
- 舆情分析: 公众舆论追踪、媒体报道分析和利益相关方认知研究
- 区域研究: 地理市场分析、地方经济状况和区域投资机会
本工具提供准确、全面的研究报告,为智能体和金融专业人士的数据驱动决策提供可靠参考。
What This Skill Does
CueCue Deep Research orchestrates multiple AI agents to:
- Analyze your research question and break it down into actionable tasks
- Research using web crawling, financial databases, and knowledge retrieval
- Synthesize findings into a comprehensive markdown report
- Generate a shareable report URL
The skill filters the verbose agent workflow to show only:
- 📋 Task titles (from the supervisor agent)
- 📝 Final research report (from the reporter agent)
- 🔗 Report URL for web viewing
⏱️ Execution Time: Depending on the complexity of your research question, the process may take 5-30 minutes. The system performs comprehensive research including web crawling, data analysis, and report generation. Please be patient and wait for the complete results.
For AI Assistants
Important: When using this skill, you MUST monitor the research progress by checking the command output:
-
Progress Monitoring: The research process outputs progress information in real-time. You should check the output every 5 minutes to:
- Verify the research is still running
- Report task progress to the user (📋 Task updates)
- Detect any errors or issues
- Inform the user when report generation begins (📝 Generating Report...)
-
Progress URL: The command will output a URL like "Research begin. You can view progress at: https://cuecue.cn/c/..." - this URL is for human users to view the web interface, NOT for you to fetch. You should monitor progress through the command's stdout output.
-
User Communication: Keep the user informed about:
- When research begins
- Each major task that starts
- When report generation begins
- When research completes
- Any errors or timeouts
-
Timeout Handling: If the command appears to hang or timeout, inform the user that the research may still be processing on the server, and they can check the web interface URL.
-
User-Facing Communication Style: When informing users about progress monitoring:
- ✅ DO SAY: "我会每 5 分钟自动检查进度并汇报" / "I'll check progress every 5 minutes and update you"
- ✅ DO SAY: "研究完成后我会总结关键发现" / "I'll summarize key findings when complete"
- ❌ DON'T SAY: "我创建了一个 cron 任务" / "I created a cron job"
- ❌ DON'T SAY: "完成后会删除 cron" / "Will delete the cron when done"
- ❌ DON'T SAY: Technical implementation details (session IDs, job IDs, internal mechanisms)
Why: Users care about what you'll do, not how you do it. Keep communication focused on outcomes and user value, not internal plumbing.
Advanced Options
import { CueCueDeepResearch } from '@sensedealai/cuecue';
const client = new CueCueDeepResearch('your-api-key', 'https://cuecue.cn');
const result = await client.research('Company analysis', {
// Continue existing conversation
conversationId: 'existing-conversation-id',
// Use a predefined template
templateId: 'template-id',
// Mimic writing style from URL
mimicUrl: 'https://example.com/article',
// Enable verbose logging
verbose: true,
});
Type Definitions
The SDK exports TypeScript types for all interfaces:
import type {
ResearchOptions,
ResearchResult,
SSEEvent,
RequestPayload,
AgentStartEvent,
AgentEndEvent,
MessageEvent,
FinalSessionStateEvent,
} from '@sensedealai/cuecue';
Command-Line Options
| Option | Required | Description |
|---|---|---|
query | ✅ | Research question or topic |
--api-key | ❌ | Your CueCue API key (defaults to CUECUE_API_KEY env var) |
--base-url | ❌ | CueCue API base URL (defaults to CUECUE_BASE_URL env var or https://cuecue.cn) |
--conversation-id | ❌ | Continue an existing conversation |
--template-id | ❌ | Use a predefined research template (cannot be used with --mimic-url) |
--mimic-url | ❌ | URL to mimic the writing style from (cannot be used with --template-id) |
--output, -o | ❌ | Save report to file (markdown format). Recommended format: ~/clawd/cuecue-reports/clawd/cuecue-reports/YYYY-MM-DD-HH-MM-descriptive-name.md (e.g., ~/clawd/2026-01-30-12-41-tesla-analysis.md). The ~ will be expanded to your home directory. |
--verbose, -v | ❌ | Enable verbose logging |
--help, -h | ❌ | Show help message |
Output Format
The skill provides real-time streaming output:
Starting Deep Research: Tesla Q3 2024 Financial Analysis
Check Progress: https://cuecue.cn/c/12345678-1234-1234-1234-123456789abc
📋 Task: Search for Tesla Q3 2024 financial data
📋 Task: Analyze revenue and profit trends
📝 Generating Report...
# Tesla Q3 2024 Financial Analysis
## Executive Summary
[Report content streams here in real-time...]
✅ Research complete
============================================================
📊 Research Summary
============================================================
Conversation ID: 12345678-1234-1234-1234-123456789abc
Tasks completed: 2
Report URL: https://cuecue.cn/c/12345678-1234-1234-1234-123456789abc
✅ Report saved to: ~/clawd/cuecue-reports/2026-01-30-10-15-tesla-q3-analysis.md
Troubleshooting
401 Unauthorized
- Verify your API key is correct
- Check if the API key has expired
- Ensure you have necessary permissions
Connection Timeout
- Verify the base URL is correct
- Check network connectivity
- Research queries typically take 5-30 minutes depending on complexity - this is normal
- If you see a timeout, the research may still be processing on the server - check the web interface
Empty Report
- Ensure your research question is clear and specific
- Check server logs for errors
- Try a different query to test connectivity
Support
For issues or questions: