How liangdabiao/amazon-sorftime-research-mcp-skill works
This repository is a collection of Amazon research skills and report-generation tools, not one application. Users initiate analyses by skill; the best-evidenced runtime paths are keyword research, product research, and Xiyou Insight, which collect or organize marketplace evidence and produce reports or dashboards. The README also documents category-selection and SellerSprite capabilities, represented where source paths exist. Evidence is uneven: several documented skills have no implementation in the supplied tree, and unsampled code relationships are omitted rather than inferred.
Main entry points: scripts/workflow.py Keyword Workflow · scripts/workflow.py Scenario Workflow · run_analysis.py Research Runner · api_client.py API Client
Components 27
Category Selection
- Category Workflow
SKILLS/skills/category-selection/scripts/workflow.py - Market Analysis
SKILLS/skills/category-selection/scripts/analyze_category.py - Category Reports
SKILLS/skills/category-selection/scripts/generate_reports.py
Keyword Research
- Keyword Workflow
SKILLS/skills/keyword-research/scripts/workflow.py - Keyword Collection
SKILLS/skills/keyword-research/scripts/keyword_collector.py - Response Parsing
SKILLS/skills/keyword-research/scripts/data_parser.py - CSV Output
SKILLS/skills/keyword-research/scripts/csv_generator.py - Markdown Report
SKILLS/skills/keyword-research/scripts/generate_markdown_report.py - HTML Dashboard
SKILLS/skills/keyword-research/scripts/generate_html_dashboard.py
Product Research
- Research Runner
SKILLS/skills/product-research/scripts/run_analysis.py - Data Collection
SKILLS/skills/product-research/scripts/collect_data.py - API Client
SKILLS/skills/product-research/scripts/api_client.py - Review Retrieval
SKILLS/skills/product-research/scripts/get_reviews.py - Research Dashboard
SKILLS/skills/product-research/scripts/render_dashboard.py
Xiyou Insight
- Scenario Workflow
SKILLS/skills/xiyou-insight/scripts/workflow.py - Scenario Registry
SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py - Scenario Base
SKILLS/skills/xiyou-insight/scripts/scenarios/base.py - Analysis Scenarios
SKILLS/skills/xiyou-insight/scripts/scenarios - Data Aggregation
SKILLS/skills/xiyou-insight/scripts/data_aggregator.py - Report Output
SKILLS/skills/xiyou-insight/scripts/report_generator.py - Visual Dashboard
SKILLS/skills/xiyou-insight/scripts/dashboard_generator.py
SellerSprite Research
- Competitor Analysis
SKILLS/skills/sellersprite-amazon-research/scripts/competitor_analysis.py - Keyword Research
SKILLS/skills/sellersprite-amazon-research/scripts/keyword_research.py - Review Analysis
SKILLS/skills/sellersprite-amazon-research/scripts/review_analysis.py - Keyword Deep Dive
SKILLS/skills/sellersprite-amazon-research/scripts/keyword_deep_analysis.py
Other components
- Researcher
- Sorftime API
Connections 27
- Researcher → Category Workflow: runs analysis
- Category Workflow → Market Analysis: analyzes market
- Category Workflow → Category Reports: generates reports
- Researcher → Keyword Workflow: runs research
SKILLS/skills/keyword-research/scripts/workflow.py - Keyword Workflow → Keyword Collection: collects terms
SKILLS/skills/keyword-research/scripts/workflow.py - Keyword Collection → Response Parsing: parses responses
SKILLS/skills/keyword-research/scripts/keyword_collector.py - Keyword Workflow → CSV Output: writes CSV
SKILLS/skills/keyword-research/scripts/workflow.py - Keyword Workflow → Markdown Report: writes report
SKILLS/skills/keyword-research/scripts/workflow.py - Keyword Workflow → HTML Dashboard: renders dashboard
SKILLS/skills/keyword-research/scripts/workflow.py - Researcher → Research Runner: starts research
- Research Runner → Data Collection: collects data
SKILLS/skills/product-research/scripts/run_analysis.py - Research Runner → API Client: uses client
SKILLS/skills/product-research/scripts/run_analysis.py - Data Collection → API Client: requests data
SKILLS/skills/product-research/scripts/collect_data.py - API Client → Sorftime API: calls API
- Research Runner → Research Dashboard: renders dashboard
SKILLS/skills/product-research/scripts/run_analysis.py - Review Retrieval → API Client: retrieves reviews
SKILLS/skills/product-research/scripts/get_reviews.py - Researcher → Scenario Workflow: selects scenario
- Scenario Workflow → Scenario Registry: loads scenarios
SKILLS/skills/xiyou-insight/scripts/workflow.py - Scenario Registry → Analysis Scenarios: registers scenarios
SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py - Analysis Scenarios → Scenario Base: extends base
SKILLS/skills/xiyou-insight/scripts/scenarios/competitor_analysis.py - Scenario Workflow → Data Aggregation: aggregates data
SKILLS/skills/xiyou-insight/scripts/workflow.py - Scenario Workflow → Report Output: generates report
SKILLS/skills/xiyou-insight/scripts/workflow.py - Scenario Workflow → Visual Dashboard: renders dashboard
SKILLS/skills/xiyou-insight/scripts/workflow.py - Researcher → Competitor Analysis: requests analysis
- Researcher → Keyword Research: requests research
- Researcher → Review Analysis: requests insights
- Researcher → Keyword Deep Dive: requests deep dive