Skip to content

AkaCoder404/shopify-adk-agent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Shopify Agent with Google ADK

A simple multi-agent workflow to help with my shopify drop-shipping:

I used this to:

  1. Learn about agent development with ADK.
  2. Conversationally interact with my shop & its products.
  3. Import products from AliExpress/Alibaba via DSers.
  4. Updated product content w/ Ai generated content.

Whats next:

  1. Provide more context of the store - may helps when generating content for products.
  2. Prompt improvement - may help improve understanding of MCPs for the Agents so better workflows.

Background

Using Google ADK Multi-Agent Hierarchy with the Coordinator/Dispatcher Pattern + Sequential Pipeline for content workflows.

graph TD
    A[ShopifyCoordinator<br/>Root Agent - Coordinator/Dispatcher] --> B[ShopifyOperationsAgent]
    A --> C[DsersOperationsAgent]
    A --> D[CsvSyncAgent]
    A --> E[ContentStudioAgent<br/>Sequential Pipeline]
    
    B --> B1[MCP: shopify-mcp]
    B --> B2[MCP: @shopify/dev-mcp]
    
    C --> C1[MCP: @akacoder404/dsers-mcp]
    C1 --> C1a[Import from AliExpress]
    C1 --> C1b[Import from Alibaba]
    C1 --> C1c[Pricing Rules]
    C1 --> C1d[Push to Store]
    
    D --> D1[Tool: read_csv]
    D --> D2[Tool: write_csv]
    D --> D3[Tool: sync_products]
    
    E --> F[TextGenerator]
    E --> G[ImageGenerator]
    E --> H[SeoOptimizer]
    
    F --> F1[Gemini 2.5 Pro<br/>text-to-text]
    G --> G1[Gemini 3.1 Flash Image<br/>text-to-image]
    G --> G2[Image Edit<br/>image-to-image]
    H --> H1[Keyword Research]
    H --> H2[SEO Optimization]
    
    style A fill:#e1f5fe
    style E fill:#fff3e0
    style F fill:#e8f5e9
    style G fill:#e8f5e9
    style H fill:#e8f5e9
Loading
ShopifyCoordinator (Root Agent)
├── ShopifyOperationsAgent (Shopify MCP tools)
├── DsersOperationsAgent (DSers import & push)
├── CsvSyncAgent (CSV read/write, product mapping)
└── ContentStudioAgent (AI content generation)
    ├── TextGenerator (title/description generation - text-to-text)
    ├── ImageGenerator (product images - text-to-image, image-to-image)
    └── SeoOptimizer (SEO optimization & keyword enhancement)

Workflows

DSers Quick Import

Import from AliExpress/Alibaba and push directly to your store:

User: "Import this product from AliExpress and push to my store: [URL]"
→ dsers_operations imports → dsers_operations pushes (with pricing rules if specified)

DSers + AI Content

Import via DSers, then generate AI content before pushing:

User: "Import from AliExpress, generate AI content, then push"
→ dsers_operations imports → content_studio generates → dsers_operations updates → dsers_operations pushes

CSV-Based Product Onboarding

For suppliers providing CSV files:

User: "Import products from supplier.csv and generate store-ready content"
→ csv_sync reads → content_studio generates → shopify_operations creates → csv_sync updates mapping

Setup

Prerequisites

  1. Shopify: Get shopify domain (xxx.myshopify.com), shopify client id, and shopify client secret after creating a new app and install app on Shopify Store.
  2. Google AI: Get google api key from https://aistudio.google.com/
  3. DSers (optional): Have a DSers account (free plan works) with Shopify store connected

Install MCP Servers

# Shopify MCP servers
npx -y @shopify/dev-mcp@latest
npx -y shopify-mcp

# DSers MCP (with OAuth login)
npx -y @akacoder404/dsers-mcp login
npx -y @akacoder404/dsers-mcp

Python Setup

python -m venv .venv
pip install -r requirements.txt

Run

adk run main

About

A simple multi-agent workflow to help with my shopify drop-shipping

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages