> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roe-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Marketplace Storefront Analysis

> Analyzes marketplace storefronts for policy compliance and risk assessment.

## Marketplace Storefront Analysis Engine Overview

The Marketplace Storefront Analysis Engine evaluates seller storefronts on marketplace platforms (like Amazon) against configured policies. It scrapes product listings, analyzes content and images, and assesses compliance with policy rules.

## Engine Inputs

The Marketplace Storefront Analysis Engine Configuration has the following parameters:

* **storefront\_url**: *optional.* The marketplace storefront URL to analyze (e.g., Amazon seller page).
* **policy\_version\_id**: *optional.* Policy version ID containing the compliance rules to evaluate against.

See [Template Strings](/agents/input-definition#template-strings) for dynamic parameter configuration.

## Engine Output

The output includes a comprehensive storefront analysis:

```json theme={null}
{
  "storefront_url": "https://amazon.com/stores/seller",
  "risk_assessments": {
    "overall_risk_score": 45,
    "overall_risk_level": "LOW | MEDIUM | HIGH",
    "summary": "Risk assessment summary",
    "recommendations": ["Recommendation 1", "Recommendation 2"]
  },
  "risk_metrics": [
    {
      "name": "Policy Category",
      "score": 60,
      "reasoning": "Assessment reasoning",
      "verdicts": [
        {
          "category": "Violation Category",
          "findings": ["Finding 1", "Finding 2"],
          "references": ["Product URL 1"]
        }
      ]
    }
  ],
  "product_categories": ["Electronics", "Home & Garden"]
}
```

## Example Usage

<Steps>
  <Step title="Create a Compliance Policy">
    First, create a Policy in the Policies section with your marketplace compliance rules and categories.
  </Step>

  <Step title="Create an Agent">
    Click on the "Add Agent" button in the top right corner of the Agents page.

    <Frame>
      <img src="https://mintcdn.com/roeai/qeWYCF2quzHQHhsD/images/add-agent.png?fit=max&auto=format&n=qeWYCF2quzHQHhsD&q=85&s=b3e1ec9b816ed1e57cb1ecfa53ff4288" width="1920" height="1045" data-path="images/add-agent.png" />
    </Frame>

    Enter a name and an optional description of your Agent.
  </Step>

  <Step title="Select the Marketplace Storefront Analysis Engine" />

  <Step title="Configure the engine">
    <Info>\$ starts a template string</Info>

    * **storefront\_url**: \$storefront\_url
    * **policy\_version\_id**: (select your policy version)
  </Step>

  <Step title="Create the Agent">
    Hit the **Create** button.
  </Step>

  <Step title="Run a job">
    Create a new job and provide the storefront URL to analyze.
  </Step>
</Steps>

## Analysis Process

The engine performs these steps:

1. **Scrape storefront**: Extract product listings from the marketplace
2. **Extract content**: Gather text and images from products
3. **Policy evaluation**: Assess each policy category against the content
4. **Risk aggregation**: Combine metrics into overall risk assessment

## Use Cases

* **Seller vetting**: Evaluate new sellers before marketplace approval
* **Compliance monitoring**: Ensure sellers meet marketplace policies
* **Quality assessment**: Evaluate product listing quality
* **Brand protection**: Identify potential counterfeit or policy-violating sellers
* **Periodic audits**: Re-evaluate existing seller storefronts