# AI Margin Guard — Shopify Margin Report (`ai-margin-guard/ai-margin-guard-report`) Actor

One-shot Shopify margin report from your product export CSV. Upload two CSVs from different dates to also detect cost changes and their margin impact. $2.99 per successful report; invalid input is never charged.

- **URL**: https://apify.com/ai-margin-guard/ai-margin-guard-report.md
- **Developed by:** [Ratmir piro](https://apify.com/ai-margin-guard) (community)
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$2,990.00 / 1,000 margin report delivereds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## AI Margin Guard — Shopify Margin Report

**$2.99 per successful report. Invalid input is never charged.**

### What you get

- **1 CSV** (your current Shopify product export) → a margin snapshot: blended gross margin, per-variant margin, priced inventory value, and cost of goods.
- **2 CSVs** from different dates → snapshot **plus** every variant whose cost changed by ≥1%, ranked by how much it hurt your margin.

### How to use

1. In Shopify: **Settings → Products → Export → All products → CSV for Excel, Numbers, or other spreadsheet programs**. Make sure "Include cost per item" is enabled (in Preferences → Products).
2. Optional: repeat the export for an older date so we can compare.
3. Run this Actor with the CSV URL(s) or paste the CSVs inline (base64).
4. You get the report as one dataset item in the run output.

### Privacy

- We only process what you paste. **We never see your Shopify credentials.**
- The uploaded CSV is discarded as soon as the report is generated.
- No customer PII from the export leaves the report.

### Want continuous monitoring?

Every report includes a link to start a **free 30-day trial** of the full AI Margin Guard app on Shopify — weekly reports, monthly review, no card required.

# Actor input Schema

## `current_csv_url` (type: `string`):

Public/signed URL to your latest Shopify products.csv export (Settings → Products → Export → CSV, with 'Cost per item' enabled). Either this or 'current\_csv\_b64' is required.

## `current_csv_b64` (type: `string`):

Alternative to the URL: paste your CSV content encoded as base64. Useful for private stores. Either this or 'current\_csv\_url' is required.

## `prior_csv_url` (type: `string`):

Optional. A URL to an older Shopify products.csv from a different date. Providing this enables cost-change detection.

## `prior_csv_b64` (type: `string`):

Alternative to prior\_csv\_url.

## `demo_mode` (type: `boolean`):

When true AND no CSV is supplied, the Actor produces a clearly-labeled fictional demo report using bundled sample data. Demo runs are NEVER billed and do NOT count as customer acquisitions. If ANY CSV is supplied (current\_csv\_url / current\_csv\_b64 / prior\_csv\_url / prior\_csv\_b64), demo\_mode is ignored and the paid customer report path is used.

## Actor input object example

```json
{
  "current_csv_url": "https://example.com/my-shop-products.csv",
  "prior_csv_url": "https://example.com/my-shop-products-2026-08.csv",
  "demo_mode": false
}
```

# Actor output Schema

## `report` (type: `string`):

The single amg\_margin\_report dataset item produced by a successful run — the report your Actor purchase delivers. Field-level structure is described in the Dataset schema.

## `reportInConsole` (type: `string`):

Human-friendly view of the same report in the Apify Console.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("ai-margin-guard/ai-margin-guard-report").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("ai-margin-guard/ai-margin-guard-report").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call ai-margin-guard/ai-margin-guard-report --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ai-margin-guard/ai-margin-guard-report"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/OQ7xva6eM8mJ0WZ43/builds/edBQzH2tNSq5qI7Zk/openapi.json