Cuecue Deep Research

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:

1. Analyze your research question and break it down into actionable tasks
2. Research using web crawling, financial databases, and knowledge retrieval
3. Synthesize findings into a comprehensive markdown report
4. 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:

1. 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...)

2. 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.

3. 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

4. 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.

5. 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

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:

• CueCue Website
• Email: cue-admin@sensedeal.ai