303 lines
8.6 KiB
Markdown
303 lines
8.6 KiB
Markdown
# Research Commands Cheat Sheet
|
|
|
|
## Quick Reference Guide
|
|
|
|
This cheat sheet provides quick access to common research commands and workflows.
|
|
|
|
## 🚀 Quick Start Commands
|
|
|
|
### Company Research
|
|
|
|
```bash
|
|
# Basic company analysis
|
|
bun scripts/company-analyzer.ts --company "Marriott International" --focus comprehensive
|
|
|
|
# Financial-focused research
|
|
bun scripts/company-analyzer.ts --company "Apple Inc" --focus financial
|
|
|
|
# Market position analysis
|
|
bun scripts/company-analyzer.ts --company "Microsoft" --focus market-position
|
|
|
|
# Foundation research (leadership, mission, values)
|
|
bun scripts/company-analyzer.ts --company "Amazon" --focus foundation
|
|
```
|
|
|
|
### Market Research
|
|
|
|
```bash
|
|
# Comprehensive market analysis
|
|
bun scripts/web-researcher.ts --query "hotel market trends 2024" --depth comprehensive
|
|
|
|
# Quick market overview
|
|
bun scripts/web-researcher.ts --query "SaaS market size" --depth quick
|
|
|
|
# Recent market developments
|
|
bun scripts/web-researcher.ts --query "fintech regulations 2024" --depth recent
|
|
|
|
# Customer segmentation research
|
|
bun scripts/web-researcher.ts --query "enterprise software customer segments" --depth comprehensive
|
|
```
|
|
|
|
### Tool/Software Research
|
|
|
|
```bash
|
|
# Tool comparison research
|
|
bun scripts/web-researcher.ts --query "project management tools comparison 2024" --depth comprehensive
|
|
|
|
# Technical evaluation
|
|
bun scripts/web-researcher.ts --query "Kubernetes vs Docker Swarm performance" --depth comprehensive
|
|
|
|
# Cost analysis research
|
|
bun scripts/web-researcher.ts --query "cloud storage pricing comparison AWS Azure GCP" --depth comprehensive
|
|
```
|
|
|
|
## 📊 Report Generation
|
|
|
|
### Generate Reports
|
|
|
|
```bash
|
|
# Generate executive summary
|
|
bun scripts/report-generator.ts --template executive-summary --input research-data.json --output exec-summary.md
|
|
|
|
# Generate comprehensive report
|
|
bun scripts/report-generator.ts --template comprehensive-analysis --input market-data.json --output full-report.md
|
|
|
|
# Generate competitive intelligence report
|
|
bun scripts/report-generator.ts --template competitive-intelligence --input competitor-data.json --output competitor-analysis.md
|
|
|
|
# Generate HTML report
|
|
bun scripts/report-generator.ts --template market-analysis --input data.json --output report.html --format html
|
|
```
|
|
|
|
### List Available Templates
|
|
|
|
```bash
|
|
bun scripts/report-generator.ts templates
|
|
```
|
|
|
|
## 🔍 Advanced Search Techniques
|
|
|
|
### Search Query Construction
|
|
|
|
```bash
|
|
# Exact phrase matching
|
|
bun scripts/web-researcher.ts --query "\"artificial intelligence in healthcare\"" --depth comprehensive
|
|
|
|
# Exclude terms
|
|
bun scripts/web-researcher.ts --query "cloud computing -AWS -Azure" --depth comprehensive
|
|
|
|
# Site-specific search
|
|
bun scripts/web-researcher.ts --query "machine learning site:arxiv.org" --depth comprehensive
|
|
|
|
# File type search
|
|
bun scripts/web-researcher.ts --query "market report filetype:pdf" --depth comprehensive
|
|
|
|
# Date-specific search
|
|
bun scripts/web-researcher.ts --query "blockchain trends 2024" --depth recent
|
|
```
|
|
|
|
### Multi-query Research
|
|
|
|
```bash
|
|
# Sequential research with different focus areas
|
|
bun scripts/web-researcher.ts --query "company X market share" --depth comprehensive
|
|
bun scripts/web-researcher.ts --query "company X financial performance" --depth comprehensive
|
|
bun scripts/web-researcher.ts --query "company X recent developments" --depth recent
|
|
bun scripts/web-researcher.ts --query "company X competitors" --depth comprehensive
|
|
```
|
|
|
|
## 📋 Research Workflows
|
|
|
|
### Complete Company Research Workflow
|
|
|
|
```bash
|
|
# Step 1: Foundation research
|
|
bun scripts/company-analyzer.ts --company "Target Company" --focus foundation
|
|
|
|
# Step 2: Financial analysis
|
|
bun scripts/company-analyzer.ts --company "Target Company" --focus financial
|
|
|
|
# Step 3: Market position
|
|
bun scripts/company-analyzer.ts --company "Target Company" --focus market-position
|
|
|
|
# Step 4: Recent developments
|
|
bun scripts/web-researcher.ts --query "Target Company recent news 2024" --depth recent
|
|
|
|
# Step 5: Generate report
|
|
bun scripts/report-generator.ts --template comprehensive-analysis --input company-research.json --output target-company-analysis.md
|
|
```
|
|
|
|
### Market Entry Research Workflow
|
|
|
|
```bash
|
|
# Step 1: Market sizing
|
|
bun scripts/web-researcher.ts --query "[Industry] market size growth 2024" --depth comprehensive
|
|
|
|
# Step 2: Competitive landscape
|
|
bun scripts/web-researcher.ts --query "[Industry] major competitors market share" --depth comprehensive
|
|
|
|
# Step 3: Regulatory environment
|
|
bun scripts/web-researcher.ts --query "[Industry] regulations compliance 2024" --depth comprehensive
|
|
|
|
# Step 4: Customer analysis
|
|
bun scripts/web-researcher.ts --query "[Industry] customer segments needs preferences" --depth comprehensive
|
|
|
|
# Step 5: Generate market analysis report
|
|
bun scripts/report-generator.ts --template market-analysis --input market-data.json --output market-entry-analysis.md
|
|
```
|
|
|
|
### Tool Evaluation Workflow
|
|
|
|
```bash
|
|
# Step 1: Feature comparison
|
|
bun scripts/web-researcher.ts --query "[Tool category] features comparison 2024" --depth comprehensive
|
|
|
|
# Step 2: Pricing analysis
|
|
bun scripts/web-researcher.ts --query "[Tool category] pricing licensing comparison" --depth comprehensive
|
|
|
|
# Step 3: User reviews
|
|
bun scripts/web-researcher.ts --query "[Specific tool] user reviews ratings" --depth comprehensive
|
|
|
|
# Step 4: Technical evaluation
|
|
bun scripts/web-researcher.ts --query "[Tool category] technical specifications performance" --depth comprehensive
|
|
|
|
# Step 5: Generate evaluation report
|
|
bun scripts/report-generator.ts --template technical-evaluation --input tool-data.json --output tool-evaluation.md
|
|
```
|
|
|
|
## 🎯 Output Formats
|
|
|
|
### JSON Format (Default)
|
|
|
|
```bash
|
|
bun scripts/web-researcher.ts --query "research topic" --output results.json
|
|
```
|
|
|
|
### Markdown Format
|
|
|
|
```bash
|
|
bun scripts/web-researcher.ts --query "research topic" --format markdown --output results.md
|
|
```
|
|
|
|
### CSV Format
|
|
|
|
```bash
|
|
bun scripts/web-researcher.ts --query "research topic" --format csv --output results.csv
|
|
```
|
|
|
|
## ⚙️ Configuration Options
|
|
|
|
### Research Depth Levels
|
|
|
|
- `quick`: Basic overview with limited sources
|
|
- `comprehensive`: Deep analysis with multiple source types
|
|
- `recent`: Focus on very recent developments
|
|
|
|
### Maximum Results
|
|
|
|
```bash
|
|
bun scripts/web-researcher.ts --query "topic" --max-results 20
|
|
```
|
|
|
|
### Source Specification
|
|
|
|
```bash
|
|
bun scripts/web-researcher.ts --query "topic" --sources "reuters.com,bloomberg.com,wsj.com"
|
|
```
|
|
|
|
## 🔧 Utility Commands
|
|
|
|
### Research History
|
|
|
|
```bash
|
|
# View recent research sessions
|
|
bun scripts/web-researcher.ts history
|
|
|
|
# View last 5 research sessions
|
|
bun scripts/web-researcher.ts history --limit 5
|
|
```
|
|
|
|
### Database Management
|
|
|
|
```bash
|
|
# The research data is stored in SQLite databases:
|
|
# - research_data.db (web research results)
|
|
# - company_analysis.db (company analysis data)
|
|
# - market_analysis.db (market research data)
|
|
|
|
# To access data directly, use sqlite3:
|
|
sqlite3 research_data.db "SELECT * FROM search_results ORDER BY timestamp DESC LIMIT 10;"
|
|
```
|
|
|
|
## 📊 Quality Assurance
|
|
|
|
### Source Verification
|
|
|
|
```bash
|
|
# Run source verification on research results
|
|
bun scripts/source-verifier.ts --sources sources.json --verification-level high
|
|
```
|
|
|
|
### Data Cleaning
|
|
|
|
```bash
|
|
# Clean and standardize research data
|
|
bun scripts/data-cleaner.ts --input raw-data.json --output clean-data.json
|
|
```
|
|
|
|
## 🚨 Common Issues and Solutions
|
|
|
|
### Search Engine Rate Limits
|
|
|
|
- If you encounter rate limits, add delays between searches
|
|
- Use multiple search engines for better coverage
|
|
- Consider reducing max-results parameter
|
|
|
|
### Data Quality Issues
|
|
|
|
- Always cross-reference important claims
|
|
- Use multiple source types for verification
|
|
- Prioritize recent and authoritative sources
|
|
|
|
### Large Result Sets
|
|
|
|
- Use specific search queries to reduce noise
|
|
- Filter by publication date when needed
|
|
- Focus on high-quality source domains
|
|
|
|
## 📚 Template Usage Guide
|
|
|
|
### Executive Summary Template
|
|
|
|
- Use for quick decision-maker overviews
|
|
- Keep to 1-2 pages maximum
|
|
- Focus on key findings and recommendations
|
|
|
|
### Comprehensive Analysis Template
|
|
|
|
- Use for detailed research documentation
|
|
- Include full methodology and source lists
|
|
- Add appendices for supporting data
|
|
|
|
### Competitive Intelligence Template
|
|
|
|
- Use for competitor analysis
|
|
- Include market positioning and SWOT analysis
|
|
- Focus on actionable competitive insights
|
|
|
|
### Technical Evaluation Template
|
|
|
|
- Use for software/tools assessment
|
|
- Include technical specifications and requirements
|
|
- Add integration and migration considerations
|
|
|
|
### Market Analysis Template
|
|
|
|
- Use for market research and sizing
|
|
- Include segmentation and trend analysis
|
|
- Add opportunity and risk assessment
|
|
|
|
---
|
|
|
|
_For detailed methodology and framework information, refer to the reference documentation in the /references directory._
|