# browser-act/skills architecture

> Architecture diagram of the GitHub repository browser-act/skills, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/browser-act/skills
- Repository: https://github.com/browser-act/skills

## Overview

This tree is a catalog of independent BrowserAct skill scripts, not the BrowserAct browser runtime described in the README. The scripts span marketplace extraction, lead generation, web research, social listening, and video data; several generate browser-executable JavaScript, while API skills call BrowserAct services directly. The README documents agents loading Skills and using BrowserAct locally or in the cloud, but it does not specify how individual catalog scripts are dispatched. The graph therefore shows only documented or excerpt-supported relationships; many listed capabilities are unsampled.

Main entry points: [`solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py`](https://github.com/browser-act/skills/blob/main/solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py) (Competitor analysis), [`solutions/search-research/web-research-assistant/scripts/research.py`](https://github.com/browser-act/skills/blob/main/solutions/search-research/web-research-assistant/scripts/research.py) (Web research), [`solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py`](https://github.com/browser-act/skills/blob/main/solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py) (Maps search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_commerce["Commerce data"]
  node_amazon_competitors["Competitor analysis"]
  node_amazon_search["Product search"]
  node_market_reviews["Marketplace reviews<br/>[extract-reviews.py]"]
end

subgraph group_leads["Lead generation"]
  node_google_maps_search["Maps search"]
  node_google_maps_contacts["Place contacts<br/>[search-places.py]"]
  node_social_contacts["Social links"]
end

subgraph group_research["Search research"]
  node_web_research["Web research<br/>[research.py]"]
  node_serp["Search results<br/>[serp-extract.py]"]
  node_deep_crawl["Deep crawl discovery"]
end

subgraph group_social["Social listening"]
  node_trustpilot["Trustpilot reviews<br/>[extract-reviews.py]"]
  node_xiaohongshu["Note search"]
  node_x_workflows["X workflows<br/>[search-users.py]"]
end

subgraph group_video["Video platforms"]
  node_douyin["Video search<br/>[search-videos.py]"]
  node_youtube_analysis["Transcript analysis"]
end

node_agent(("AI agent"))
node_browseract_mcp{{"BrowserAct MCP"}}
node_browseract_workflow_api{{"BrowserAct workflow API"}}

node_agent -->|"runs skill"| node_web_research
node_web_research -->|"searches via"| node_browseract_mcp
node_agent -->|"runs skill"| node_amazon_competitors
node_amazon_competitors -->|"submits tasks"| node_browseract_workflow_api
node_google_maps_search -->|"submits tasks"| node_browseract_workflow_api

click node_amazon_competitors "https://github.com/browser-act/skills/blob/main/solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py"
click node_amazon_search "https://github.com/browser-act/skills/blob/main/solutions/ecommerce/amazon-product-search-api-skill/scripts/amazon_product_search_api.py"
click node_market_reviews "https://github.com/browser-act/skills/blob/main/solutions/ecommerce/ecommerce-reviews/scripts/extract-reviews.py"
click node_google_maps_search "https://github.com/browser-act/skills/blob/main/solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py"
click node_google_maps_contacts "https://github.com/browser-act/skills/blob/main/solutions/lead-generation/google-maps-contact-extract/scripts/search-places.py"
click node_social_contacts "https://github.com/browser-act/skills/blob/main/solutions/lead-generation/business-contact-social-links-skill/scripts/business_contact_social_links.py"
click node_web_research "https://github.com/browser-act/skills/blob/main/solutions/search-research/web-research-assistant/scripts/research.py"
click node_serp "https://github.com/browser-act/skills/blob/main/solutions/search-research/google-search-serp/scripts/serp-extract.py"
click node_deep_crawl "https://github.com/browser-act/skills/blob/main/solutions/search-research/webcrawler-deep-crawl/scripts/discover-llms-txt.py"
click node_trustpilot "https://github.com/browser-act/skills/blob/main/solutions/social-listening/trustpilot-reviews/scripts/extract-reviews.py"
click node_xiaohongshu "https://github.com/browser-act/skills/blob/main/solutions/social-listening/xiaohongshu-search-full/scripts/extract-search-feeds.py"
click node_x_workflows "https://github.com/browser-act/skills/blob/main/solutions/social-listening/x-dm-auto-chat/scripts/search-users.py"
click node_douyin "https://github.com/browser-act/skills/blob/main/solutions/video-platforms/douyin-video-search/scripts/search-videos.py"
click node_youtube_analysis "https://github.com/browser-act/skills/blob/main/solutions/video-platforms/youtube-transcript-analysis-api-skill/scripts/youtube_transcript_analysis_api.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_amazon_competitors,node_amazon_search,node_market_reviews,node_browseract_mcp,node_browseract_workflow_api toneBlue
class node_google_maps_search,node_google_maps_contacts,node_social_contacts toneAmber
class node_web_research,node_serp,node_deep_crawl toneMint
class node_trustpilot,node_xiaohongshu,node_x_workflows toneRose
class node_douyin,node_youtube_analysis,node_agent toneIndigo
```

## Components

### Commerce data

- [Competitor analysis](https://github.com/browser-act/skills/blob/main/solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py): `solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py`
- [Product search](https://github.com/browser-act/skills/blob/main/solutions/ecommerce/amazon-product-search-api-skill/scripts/amazon_product_search_api.py): `solutions/ecommerce/amazon-product-search-api-skill/scripts/amazon_product_search_api.py`
- [Marketplace reviews](https://github.com/browser-act/skills/blob/main/solutions/ecommerce/ecommerce-reviews/scripts/extract-reviews.py): `solutions/ecommerce/ecommerce-reviews/scripts/extract-reviews.py`

### Lead generation

- [Maps search](https://github.com/browser-act/skills/blob/main/solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py): `solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py`
- [Place contacts](https://github.com/browser-act/skills/blob/main/solutions/lead-generation/google-maps-contact-extract/scripts/search-places.py): `solutions/lead-generation/google-maps-contact-extract/scripts/search-places.py`
- [Social links](https://github.com/browser-act/skills/blob/main/solutions/lead-generation/business-contact-social-links-skill/scripts/business_contact_social_links.py): `solutions/lead-generation/business-contact-social-links-skill/scripts/business_contact_social_links.py`

### Search research

- [Web research](https://github.com/browser-act/skills/blob/main/solutions/search-research/web-research-assistant/scripts/research.py): `solutions/search-research/web-research-assistant/scripts/research.py`
- [Search results](https://github.com/browser-act/skills/blob/main/solutions/search-research/google-search-serp/scripts/serp-extract.py): `solutions/search-research/google-search-serp/scripts/serp-extract.py`
- [Deep crawl discovery](https://github.com/browser-act/skills/blob/main/solutions/search-research/webcrawler-deep-crawl/scripts/discover-llms-txt.py): `solutions/search-research/webcrawler-deep-crawl/scripts/discover-llms-txt.py`

### Social listening

- [Trustpilot reviews](https://github.com/browser-act/skills/blob/main/solutions/social-listening/trustpilot-reviews/scripts/extract-reviews.py): `solutions/social-listening/trustpilot-reviews/scripts/extract-reviews.py`
- [Note search](https://github.com/browser-act/skills/blob/main/solutions/social-listening/xiaohongshu-search-full/scripts/extract-search-feeds.py): `solutions/social-listening/xiaohongshu-search-full/scripts/extract-search-feeds.py`
- [X workflows](https://github.com/browser-act/skills/blob/main/solutions/social-listening/x-dm-auto-chat/scripts/search-users.py): `solutions/social-listening/x-dm-auto-chat/scripts/search-users.py`

### Video platforms

- [Video search](https://github.com/browser-act/skills/blob/main/solutions/video-platforms/douyin-video-search/scripts/search-videos.py): `solutions/video-platforms/douyin-video-search/scripts/search-videos.py`
- [Transcript analysis](https://github.com/browser-act/skills/blob/main/solutions/video-platforms/youtube-transcript-analysis-api-skill/scripts/youtube_transcript_analysis_api.py): `solutions/video-platforms/youtube-transcript-analysis-api-skill/scripts/youtube_transcript_analysis_api.py`

### Other components

- **AI agent**
- **BrowserAct MCP**
- **BrowserAct workflow API**

## Connections

- AI agent → Web research: runs skill
- Web research → BrowserAct MCP: searches via (evidence: `solutions/search-research/web-research-assistant/scripts/research.py`)
- AI agent → Competitor analysis: runs skill
- Competitor analysis → BrowserAct workflow API: submits tasks (evidence: `solutions/ecommerce/amazon-competitor-analyzer/amazon_competitor_analyzer.py`)
- Maps search → BrowserAct workflow API: submits tasks (evidence: `solutions/lead-generation/google-maps-search-api-skill/scripts/google_maps_search_api.py`)