# liangdabiao/amazon-sorftime-research-mcp-skill architecture

> Architecture diagram of the GitHub repository liangdabiao/amazon-sorftime-research-mcp-skill, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/liangdabiao/amazon-sorftime-research-mcp-skill
- Repository: https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill

## Overview

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: [`SKILLS/skills/keyword-research/scripts/workflow.py`](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/workflow.py) (Keyword Workflow), [`SKILLS/skills/xiyou-insight/scripts/workflow.py`](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/workflow.py) (Scenario Workflow), [`SKILLS/skills/product-research/scripts/run_analysis.py`](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/run_analysis.py) (Research Runner), [`SKILLS/skills/product-research/scripts/api_client.py`](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/api_client.py) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_category["Category Selection"]
  node_category_workflow["Category Workflow<br/>[workflow.py]"]
  node_category_analysis["Market Analysis"]
  node_category_reports["Category Reports"]
end

subgraph group_keywords["Keyword Research"]
  node_keyword_workflow["Keyword Workflow<br/>[workflow.py]"]
  node_keyword_collect["Keyword Collection"]
  node_keyword_parse["Response Parsing<br/>[data_parser.py]"]
  node_keyword_csv["CSV Output<br/>[csv_generator.py]"]
  node_keyword_md["Markdown Report"]
  node_keyword_dashboard["HTML Dashboard"]
end

subgraph group_product["Product Research"]
  node_product_run["Research Runner<br/>[run_analysis.py]"]
  node_product_collect["Data Collection<br/>[collect_data.py]"]
  node_product_client["API Client<br/>[api_client.py]"]
  node_product_reviews["Review Retrieval<br/>[get_reviews.py]"]
  node_product_dashboard["Research Dashboard"]
end

subgraph group_xiyou["Xiyou Insight"]
  node_xiyou_workflow["Scenario Workflow<br/>[workflow.py]"]
  node_xiyou_registry["Scenario Registry<br/>[__init__.py]"]
  node_xiyou_base["Scenario Base<br/>[base.py]"]
  node_xiyou_scenarios["Analysis Scenarios"]
  node_xiyou_aggregator["Data Aggregation<br/>[data_aggregator.py]"]
  node_xiyou_report["Report Output"]
  node_xiyou_dashboard["Visual Dashboard"]
end

subgraph group_seller["SellerSprite Research"]
  node_seller_competitor["Competitor Analysis"]
  node_seller_keywords["Keyword Research"]
  node_seller_reviews["Review Analysis<br/>[review_analysis.py]"]
  node_seller_deep_keywords["Keyword Deep Dive"]
end

node_analyst(("Researcher"))
node_sorftime{{"Sorftime API"}}

node_analyst -->|"runs analysis"| node_category_workflow
node_category_workflow -.->|"analyzes market"| node_category_analysis
node_category_workflow -.->|"generates reports"| node_category_reports
node_analyst -->|"runs research"| node_keyword_workflow
node_keyword_workflow -->|"collects terms"| node_keyword_collect
node_keyword_collect -->|"parses responses"| node_keyword_parse
node_keyword_workflow -->|"writes CSV"| node_keyword_csv
node_keyword_workflow -->|"writes report"| node_keyword_md
node_keyword_workflow -->|"renders dashboard"| node_keyword_dashboard
node_analyst -->|"starts research"| node_product_run
node_product_run -->|"collects data"| node_product_collect
node_product_run -->|"uses client"| node_product_client
node_product_collect -->|"requests data"| node_product_client
node_product_client -.->|"calls API"| node_sorftime
node_product_run -->|"renders dashboard"| node_product_dashboard
node_product_reviews -->|"retrieves reviews"| node_product_client
node_analyst -->|"selects scenario"| node_xiyou_workflow
node_xiyou_workflow -->|"loads scenarios"| node_xiyou_registry
node_xiyou_registry -->|"registers scenarios"| node_xiyou_scenarios
node_xiyou_scenarios -->|"extends base"| node_xiyou_base
node_xiyou_workflow -->|"aggregates data"| node_xiyou_aggregator
node_xiyou_workflow -->|"generates report"| node_xiyou_report
node_xiyou_workflow -->|"renders dashboard"| node_xiyou_dashboard
node_analyst -->|"requests analysis"| node_seller_competitor
node_analyst -->|"requests research"| node_seller_keywords
node_analyst -->|"requests insights"| node_seller_reviews
node_analyst -.->|"requests deep dive"| node_seller_deep_keywords

click node_category_workflow "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/workflow.py"
click node_category_analysis "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/analyze_category.py"
click node_category_reports "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/generate_reports.py"
click node_keyword_workflow "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/workflow.py"
click node_keyword_collect "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/keyword_collector.py"
click node_keyword_parse "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/data_parser.py"
click node_keyword_csv "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/csv_generator.py"
click node_keyword_md "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/generate_markdown_report.py"
click node_keyword_dashboard "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/generate_html_dashboard.py"
click node_product_run "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/run_analysis.py"
click node_product_collect "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/collect_data.py"
click node_product_client "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/api_client.py"
click node_product_reviews "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/get_reviews.py"
click node_product_dashboard "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/render_dashboard.py"
click node_xiyou_workflow "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/workflow.py"
click node_xiyou_registry "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py"
click node_xiyou_base "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/scenarios/base.py"
click node_xiyou_scenarios "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/tree/main/SKILLS/skills/xiyou-insight/scripts/scenarios"
click node_xiyou_aggregator "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/data_aggregator.py"
click node_xiyou_report "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/report_generator.py"
click node_xiyou_dashboard "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/dashboard_generator.py"
click node_seller_competitor "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/competitor_analysis.py"
click node_seller_keywords "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/keyword_research.py"
click node_seller_reviews "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/review_analysis.py"
click node_seller_deep_keywords "https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/keyword_deep_analysis.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_category_workflow,node_category_analysis,node_category_reports toneBlue
class node_keyword_workflow,node_keyword_collect,node_keyword_parse,node_keyword_csv,node_keyword_md,node_keyword_dashboard toneAmber
class node_product_run,node_product_collect,node_product_client,node_product_reviews,node_product_dashboard,node_sorftime toneMint
class node_xiyou_workflow,node_xiyou_registry,node_xiyou_base,node_xiyou_scenarios,node_xiyou_aggregator,node_xiyou_report,node_xiyou_dashboard toneRose
class node_seller_competitor,node_seller_keywords,node_seller_reviews,node_seller_deep_keywords,node_analyst toneIndigo
```

## Components

### Category Selection

- [Category Workflow](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/workflow.py): `SKILLS/skills/category-selection/scripts/workflow.py`
- [Market Analysis](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/analyze_category.py): `SKILLS/skills/category-selection/scripts/analyze_category.py`
- [Category Reports](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/category-selection/scripts/generate_reports.py): `SKILLS/skills/category-selection/scripts/generate_reports.py`

### Keyword Research

- [Keyword Workflow](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/workflow.py): `SKILLS/skills/keyword-research/scripts/workflow.py`
- [Keyword Collection](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/keyword_collector.py): `SKILLS/skills/keyword-research/scripts/keyword_collector.py`
- [Response Parsing](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/data_parser.py): `SKILLS/skills/keyword-research/scripts/data_parser.py`
- [CSV Output](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/csv_generator.py): `SKILLS/skills/keyword-research/scripts/csv_generator.py`
- [Markdown Report](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/generate_markdown_report.py): `SKILLS/skills/keyword-research/scripts/generate_markdown_report.py`
- [HTML Dashboard](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/keyword-research/scripts/generate_html_dashboard.py): `SKILLS/skills/keyword-research/scripts/generate_html_dashboard.py`

### Product Research

- [Research Runner](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/run_analysis.py): `SKILLS/skills/product-research/scripts/run_analysis.py`
- [Data Collection](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/collect_data.py): `SKILLS/skills/product-research/scripts/collect_data.py`
- [API Client](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/api_client.py): `SKILLS/skills/product-research/scripts/api_client.py`
- [Review Retrieval](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/get_reviews.py): `SKILLS/skills/product-research/scripts/get_reviews.py`
- [Research Dashboard](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/product-research/scripts/render_dashboard.py): `SKILLS/skills/product-research/scripts/render_dashboard.py`

### Xiyou Insight

- [Scenario Workflow](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/workflow.py): `SKILLS/skills/xiyou-insight/scripts/workflow.py`
- [Scenario Registry](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py): `SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py`
- [Scenario Base](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/scenarios/base.py): `SKILLS/skills/xiyou-insight/scripts/scenarios/base.py`
- [Analysis Scenarios](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/tree/main/SKILLS/skills/xiyou-insight/scripts/scenarios): `SKILLS/skills/xiyou-insight/scripts/scenarios`
- [Data Aggregation](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/data_aggregator.py): `SKILLS/skills/xiyou-insight/scripts/data_aggregator.py`
- [Report Output](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/report_generator.py): `SKILLS/skills/xiyou-insight/scripts/report_generator.py`
- [Visual Dashboard](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/xiyou-insight/scripts/dashboard_generator.py): `SKILLS/skills/xiyou-insight/scripts/dashboard_generator.py`

### SellerSprite Research

- [Competitor Analysis](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/competitor_analysis.py): `SKILLS/skills/sellersprite-amazon-research/scripts/competitor_analysis.py`
- [Keyword Research](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/keyword_research.py): `SKILLS/skills/sellersprite-amazon-research/scripts/keyword_research.py`
- [Review Analysis](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/review_analysis.py): `SKILLS/skills/sellersprite-amazon-research/scripts/review_analysis.py`
- [Keyword Deep Dive](https://github.com/liangdabiao/amazon-sorftime-research-mcp-skill/blob/main/SKILLS/skills/sellersprite-amazon-research/scripts/keyword_deep_analysis.py): `SKILLS/skills/sellersprite-amazon-research/scripts/keyword_deep_analysis.py`

### Other components

- **Researcher**
- **Sorftime API**

## Connections

- Researcher → Category Workflow: runs analysis
- Category Workflow → Market Analysis: analyzes market
- Category Workflow → Category Reports: generates reports
- Researcher → Keyword Workflow: runs research (evidence: `SKILLS/skills/keyword-research/scripts/workflow.py`)
- Keyword Workflow → Keyword Collection: collects terms (evidence: `SKILLS/skills/keyword-research/scripts/workflow.py`)
- Keyword Collection → Response Parsing: parses responses (evidence: `SKILLS/skills/keyword-research/scripts/keyword_collector.py`)
- Keyword Workflow → CSV Output: writes CSV (evidence: `SKILLS/skills/keyword-research/scripts/workflow.py`)
- Keyword Workflow → Markdown Report: writes report (evidence: `SKILLS/skills/keyword-research/scripts/workflow.py`)
- Keyword Workflow → HTML Dashboard: renders dashboard (evidence: `SKILLS/skills/keyword-research/scripts/workflow.py`)
- Researcher → Research Runner: starts research
- Research Runner → Data Collection: collects data (evidence: `SKILLS/skills/product-research/scripts/run_analysis.py`)
- Research Runner → API Client: uses client (evidence: `SKILLS/skills/product-research/scripts/run_analysis.py`)
- Data Collection → API Client: requests data (evidence: `SKILLS/skills/product-research/scripts/collect_data.py`)
- API Client → Sorftime API: calls API
- Research Runner → Research Dashboard: renders dashboard (evidence: `SKILLS/skills/product-research/scripts/run_analysis.py`)
- Review Retrieval → API Client: retrieves reviews (evidence: `SKILLS/skills/product-research/scripts/get_reviews.py`)
- Researcher → Scenario Workflow: selects scenario
- Scenario Workflow → Scenario Registry: loads scenarios (evidence: `SKILLS/skills/xiyou-insight/scripts/workflow.py`)
- Scenario Registry → Analysis Scenarios: registers scenarios (evidence: `SKILLS/skills/xiyou-insight/scripts/scenarios/__init__.py`)
- Analysis Scenarios → Scenario Base: extends base (evidence: `SKILLS/skills/xiyou-insight/scripts/scenarios/competitor_analysis.py`)
- Scenario Workflow → Data Aggregation: aggregates data (evidence: `SKILLS/skills/xiyou-insight/scripts/workflow.py`)
- Scenario Workflow → Report Output: generates report (evidence: `SKILLS/skills/xiyou-insight/scripts/workflow.py`)
- Scenario Workflow → Visual Dashboard: renders dashboard (evidence: `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
