airbyte-agent-shopify 0.1.17__tar.gz

airbyte_agent_shopify-0.1.17/.gitignore

@@ -0,0 +1,29 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+
+# OS
+.DS_Store
+Thumbs.db
+
+.env
+configured_connectors.yaml

airbyte_agent_shopify-0.1.17/AUTH.md

@@ -0,0 +1,110 @@
+# Shopify authentication and configuration
+
+This page documents the authentication and configuration options for the Shopify agent connector.
+
+## Authentication
+
+### Open source execution
+
+In open source mode, you provide API credentials directly to the connector.
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Shopify Admin API access token |
+| `shop` | `str` | Yes | Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com) |
+
+Example request:
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+from airbyte_agent_shopify.models import ShopifyAuthConfig
+
+connector = ShopifyConnector(
+    auth_config=ShopifyAuthConfig(
+        api_key="<Your Shopify Admin API access token>",
+        shop="<Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com)>"
+    )
+)
+```
+
+### Hosted execution
+
+In hosted mode, you first create a connector via the Airbyte API (providing your OAuth or Token credentials), then execute operations using either the Python SDK or API. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+#### OAuth
+This authentication method isn't available for this connector.
+
+#### Token
+Create a connector with Token credentials.
+
+
+`credentials` fields you need:
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `api_key` | `str` | Yes | Your Shopify Admin API access token |
+| `shop` | `str` | Yes | Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com) |
+
+Example request:
+
+
+```bash
+curl -X POST "https://api.airbyte.ai/v1/integrations/connectors" \
+  -H "Authorization: Bearer <SCOPED_TOKEN>" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "external_user_id": "<EXTERNAL_USER_ID>",
+    "connector_type": "Shopify",
+    "name": "My Shopify Connector",
+    "credentials": {
+      "api_key": "<Your Shopify Admin API access token>",
+      "shop": "<Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com)>"
+    }
+  }'
+```
+
+#### Execution
+
+After creating the connector, execute operations using either the Python SDK or API.
+
+**Python SDK**
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+
+connector = ShopifyConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ShopifyConnector.tool_utils
+async def shopify_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+**API**
+
+```bash
+curl -X POST 'https://api.airbyte.ai/api/v1/connectors/sources/<connector_id>/execute' \
+  -H 'Authorization: Bearer <SCOPED_TOKEN>' \
+  -H 'Content-Type: application/json' \
+  -d '{"entity": "<entity>", "action": "<action>", "params": {}}'
+```
+
+
+## Configuration
+
+The Shopify connector requires the following configuration variables. These variables are used to construct the base API URL. Pass them via the `config` parameter when initializing the connector.
+
+| Variable | Type | Required | Default | Description |
+|----------|------|----------|---------|-------------|
+| `shop` | `string` | Yes | my-store | Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com) |

airbyte_agent_shopify-0.1.17/CHANGELOG.md

@@ -0,0 +1,91 @@
+# Shopify changelog
+
+## [0.1.17] - 2026-01-28
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: f6c6fca2
+- SDK version: 0.1.0
+
+## [0.1.16] - 2026-01-28
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 71f48c10
+- SDK version: 0.1.0
+
+## [0.1.15] - 2026-01-27
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: 0f5e1914
+- SDK version: 0.1.0
+
+## [0.1.14] - 2026-01-27
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: a01f6b16
+- SDK version: 0.1.0
+
+## [0.1.13] - 2026-01-27
+- Updated connector definition (YAML version 0.1.2)
+- Source commit: c9b05509
+- SDK version: 0.1.0
+
+## [0.1.12] - 2026-01-27
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 4bded58d
+- SDK version: 0.1.0
+
+## [0.1.11] - 2026-01-26
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 74809153
+- SDK version: 0.1.0
+
+## [0.1.10] - 2026-01-26
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: b73c71e0
+- SDK version: 0.1.0
+
+## [0.1.9] - 2026-01-24
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 609c1d86
+- SDK version: 0.1.0
+
+## [0.1.8] - 2026-01-23
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 416466da
+- SDK version: 0.1.0
+
+## [0.1.7] - 2026-01-23
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: f17cdd8c
+- SDK version: 0.1.0
+
+## [0.1.6] - 2026-01-22
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 49e6dfe9
+- SDK version: 0.1.0
+
+## [0.1.5] - 2026-01-22
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: b27328e2
+- SDK version: 0.1.0
+
+## [0.1.4] - 2026-01-22
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 1da193dd
+- SDK version: 0.1.0
+
+## [0.1.3] - 2026-01-22
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: c713ec48
+- SDK version: 0.1.0
+
+## [0.1.2] - 2026-01-21
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: c7dab975
+- SDK version: 0.1.0
+
+## [0.1.1] - 2026-01-19
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 529cebb7
+- SDK version: 0.1.0
+
+## [0.1.0] - 2026-01-17
+- Updated connector definition (YAML version 0.1.1)
+- Source commit: 7c6c8361
+- SDK version: 0.1.0

airbyte_agent_shopify-0.1.17/PKG-INFO

@@ -0,0 +1,176 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-shopify
+Version: 0.1.17
+Summary: Airbyte Shopify Connector for AI platforms
+Project-URL: Homepage, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Documentation, https://docs.airbyte.com/ai-agents/
+Project-URL: Repository, https://github.com/airbytehq/airbyte-agent-connectors
+Project-URL: Issues, https://github.com/airbytehq/airbyte-agent-connectors/issues
+Author-email: Airbyte <contact@airbyte.io>
+License: Elastic-2.0
+Keywords: agent,ai,airbyte,api,connector,data-integration,llm,mcp,shopify
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: jsonpath-ng>=1.6.1
+Requires-Dist: jsonref>=1.1.0
+Requires-Dist: opentelemetry-api>=1.37.0
+Requires-Dist: opentelemetry-sdk>=1.37.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: segment-analytics-python>=2.2.0
+Description-Content-Type: text/markdown
+
+# Shopify agent connector
+
+Shopify is an e-commerce platform that enables businesses to create online stores,
+manage products, process orders, and handle customer relationships. This connector
+provides access to Shopify Admin REST API for reading store data including customers,
+orders, products, inventory, and more.
+
+
+## Example questions
+
+The Shopify connector is optimized to handle prompts like these.
+
+- List all customers in my Shopify store
+- Show me orders from the last 30 days
+- Get details for customer \{customer_id\}
+- What products do I have in my store?
+- Show me abandoned checkouts from this week
+- List all locations for my store
+- Get inventory levels for location \{location_id\}
+- Show me all draft orders
+- What price rules are currently active?
+- List all custom collections in my store
+- Get details for order \{order_id\}
+- Show me product variants for product \{product_id\}
+
+## Unsupported questions
+
+The Shopify connector isn't currently able to handle prompts like these.
+
+- Create a new customer in Shopify
+- Update product pricing
+- Delete an order
+- Process a refund
+- Send shipping notification to customer
+- Create a new discount code
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-shopify
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+from airbyte_agent_shopify.models import ShopifyAuthConfig
+
+connector = ShopifyConnector(
+    auth_config=ShopifyAuthConfig(
+        api_key="<Your Shopify Admin API access token>",
+        shop="<Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ShopifyConnector.tool_utils
+async def shopify_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+
+connector = ShopifyConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ShopifyConnector.tool_utils
+async def shopify_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customers | [List](./REFERENCE.md#customers-list), [Get](./REFERENCE.md#customers-get) |
+| Orders | [List](./REFERENCE.md#orders-list), [Get](./REFERENCE.md#orders-get) |
+| Products | [List](./REFERENCE.md#products-list), [Get](./REFERENCE.md#products-get) |
+| Product Variants | [List](./REFERENCE.md#product-variants-list), [Get](./REFERENCE.md#product-variants-get) |
+| Product Images | [List](./REFERENCE.md#product-images-list), [Get](./REFERENCE.md#product-images-get) |
+| Abandoned Checkouts | [List](./REFERENCE.md#abandoned-checkouts-list) |
+| Locations | [List](./REFERENCE.md#locations-list), [Get](./REFERENCE.md#locations-get) |
+| Inventory Levels | [List](./REFERENCE.md#inventory-levels-list) |
+| Inventory Items | [List](./REFERENCE.md#inventory-items-list), [Get](./REFERENCE.md#inventory-items-get) |
+| Shop | [Get](./REFERENCE.md#shop-get) |
+| Price Rules | [List](./REFERENCE.md#price-rules-list), [Get](./REFERENCE.md#price-rules-get) |
+| Discount Codes | [List](./REFERENCE.md#discount-codes-list), [Get](./REFERENCE.md#discount-codes-get) |
+| Custom Collections | [List](./REFERENCE.md#custom-collections-list), [Get](./REFERENCE.md#custom-collections-get) |
+| Smart Collections | [List](./REFERENCE.md#smart-collections-list), [Get](./REFERENCE.md#smart-collections-get) |
+| Collects | [List](./REFERENCE.md#collects-list), [Get](./REFERENCE.md#collects-get) |
+| Draft Orders | [List](./REFERENCE.md#draft-orders-list), [Get](./REFERENCE.md#draft-orders-get) |
+| Fulfillments | [List](./REFERENCE.md#fulfillments-list), [Get](./REFERENCE.md#fulfillments-get) |
+| Order Refunds | [List](./REFERENCE.md#order-refunds-list), [Get](./REFERENCE.md#order-refunds-get) |
+| Transactions | [List](./REFERENCE.md#transactions-list), [Get](./REFERENCE.md#transactions-get) |
+| Tender Transactions | [List](./REFERENCE.md#tender-transactions-list) |
+| Countries | [List](./REFERENCE.md#countries-list), [Get](./REFERENCE.md#countries-get) |
+| Metafield Shops | [List](./REFERENCE.md#metafield-shops-list), [Get](./REFERENCE.md#metafield-shops-get) |
+| Metafield Customers | [List](./REFERENCE.md#metafield-customers-list) |
+| Metafield Products | [List](./REFERENCE.md#metafield-products-list) |
+| Metafield Orders | [List](./REFERENCE.md#metafield-orders-list) |
+| Metafield Draft Orders | [List](./REFERENCE.md#metafield-draft-orders-list) |
+| Metafield Locations | [List](./REFERENCE.md#metafield-locations-list) |
+| Metafield Product Variants | [List](./REFERENCE.md#metafield-product-variants-list) |
+| Metafield Smart Collections | [List](./REFERENCE.md#metafield-smart-collections-list) |
+| Metafield Product Images | [List](./REFERENCE.md#metafield-product-images-list) |
+| Customer Address | [List](./REFERENCE.md#customer-address-list), [Get](./REFERENCE.md#customer-address-get) |
+| Fulfillment Orders | [List](./REFERENCE.md#fulfillment-orders-list), [Get](./REFERENCE.md#fulfillment-orders-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Shopify API docs
+
+See the official [Shopify API reference](https://shopify.dev/docs/api/admin-rest).
+
+## Version information
+
+- **Package version:** 0.1.17
+- **Connector version:** 0.1.2
+- **Generated with Connector SDK commit SHA:** f6c6fca292b291b200b31e4056856465129ae703

airbyte_agent_shopify-0.1.17/README.md

@@ -0,0 +1,143 @@
+# Shopify agent connector
+
+Shopify is an e-commerce platform that enables businesses to create online stores,
+manage products, process orders, and handle customer relationships. This connector
+provides access to Shopify Admin REST API for reading store data including customers,
+orders, products, inventory, and more.
+
+
+## Example questions
+
+The Shopify connector is optimized to handle prompts like these.
+
+- List all customers in my Shopify store
+- Show me orders from the last 30 days
+- Get details for customer \{customer_id\}
+- What products do I have in my store?
+- Show me abandoned checkouts from this week
+- List all locations for my store
+- Get inventory levels for location \{location_id\}
+- Show me all draft orders
+- What price rules are currently active?
+- List all custom collections in my store
+- Get details for order \{order_id\}
+- Show me product variants for product \{product_id\}
+
+## Unsupported questions
+
+The Shopify connector isn't currently able to handle prompts like these.
+
+- Create a new customer in Shopify
+- Update product pricing
+- Delete an order
+- Process a refund
+- Send shipping notification to customer
+- Create a new discount code
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-shopify
+```
+
+## Usage
+
+Connectors can run in open source or hosted mode.
+
+### Open source
+
+In open source mode, you provide API credentials directly to the connector.
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+from airbyte_agent_shopify.models import ShopifyAuthConfig
+
+connector = ShopifyConnector(
+    auth_config=ShopifyAuthConfig(
+        api_key="<Your Shopify Admin API access token>",
+        shop="<Your Shopify store name (e.g., 'my-store' from my-store.myshopify.com)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ShopifyConnector.tool_utils
+async def shopify_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+### Hosted
+
+In hosted mode, API credentials are stored securely in Airbyte Cloud. You provide your Airbyte credentials instead. 
+
+This example assumes you've already authenticated your connector with Airbyte. See [Authentication](AUTH.md) to learn more about authenticating. If you need a step-by-step guide, see the [hosted execution tutorial](https://docs.airbyte.com/ai-agents/quickstarts/tutorial-hosted).
+
+```python
+from airbyte_agent_shopify import ShopifyConnector
+
+connector = ShopifyConnector(
+    external_user_id="<your_external_user_id>",
+    airbyte_client_id="<your-client-id>",
+    airbyte_client_secret="<your-client-secret>"
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@ShopifyConnector.tool_utils
+async def shopify_execute(entity: str, action: str, params: dict | None = None):
+    return await connector.execute(entity, action, params or {})
+```
+
+## Full documentation
+
+### Entities and actions
+
+This connector supports the following entities and actions. For more details, see this connector's [full reference documentation](REFERENCE.md).
+
+| Entity | Actions |
+|--------|---------|
+| Customers | [List](./REFERENCE.md#customers-list), [Get](./REFERENCE.md#customers-get) |
+| Orders | [List](./REFERENCE.md#orders-list), [Get](./REFERENCE.md#orders-get) |
+| Products | [List](./REFERENCE.md#products-list), [Get](./REFERENCE.md#products-get) |
+| Product Variants | [List](./REFERENCE.md#product-variants-list), [Get](./REFERENCE.md#product-variants-get) |
+| Product Images | [List](./REFERENCE.md#product-images-list), [Get](./REFERENCE.md#product-images-get) |
+| Abandoned Checkouts | [List](./REFERENCE.md#abandoned-checkouts-list) |
+| Locations | [List](./REFERENCE.md#locations-list), [Get](./REFERENCE.md#locations-get) |
+| Inventory Levels | [List](./REFERENCE.md#inventory-levels-list) |
+| Inventory Items | [List](./REFERENCE.md#inventory-items-list), [Get](./REFERENCE.md#inventory-items-get) |
+| Shop | [Get](./REFERENCE.md#shop-get) |
+| Price Rules | [List](./REFERENCE.md#price-rules-list), [Get](./REFERENCE.md#price-rules-get) |
+| Discount Codes | [List](./REFERENCE.md#discount-codes-list), [Get](./REFERENCE.md#discount-codes-get) |
+| Custom Collections | [List](./REFERENCE.md#custom-collections-list), [Get](./REFERENCE.md#custom-collections-get) |
+| Smart Collections | [List](./REFERENCE.md#smart-collections-list), [Get](./REFERENCE.md#smart-collections-get) |
+| Collects | [List](./REFERENCE.md#collects-list), [Get](./REFERENCE.md#collects-get) |
+| Draft Orders | [List](./REFERENCE.md#draft-orders-list), [Get](./REFERENCE.md#draft-orders-get) |
+| Fulfillments | [List](./REFERENCE.md#fulfillments-list), [Get](./REFERENCE.md#fulfillments-get) |
+| Order Refunds | [List](./REFERENCE.md#order-refunds-list), [Get](./REFERENCE.md#order-refunds-get) |
+| Transactions | [List](./REFERENCE.md#transactions-list), [Get](./REFERENCE.md#transactions-get) |
+| Tender Transactions | [List](./REFERENCE.md#tender-transactions-list) |
+| Countries | [List](./REFERENCE.md#countries-list), [Get](./REFERENCE.md#countries-get) |
+| Metafield Shops | [List](./REFERENCE.md#metafield-shops-list), [Get](./REFERENCE.md#metafield-shops-get) |
+| Metafield Customers | [List](./REFERENCE.md#metafield-customers-list) |
+| Metafield Products | [List](./REFERENCE.md#metafield-products-list) |
+| Metafield Orders | [List](./REFERENCE.md#metafield-orders-list) |
+| Metafield Draft Orders | [List](./REFERENCE.md#metafield-draft-orders-list) |
+| Metafield Locations | [List](./REFERENCE.md#metafield-locations-list) |
+| Metafield Product Variants | [List](./REFERENCE.md#metafield-product-variants-list) |
+| Metafield Smart Collections | [List](./REFERENCE.md#metafield-smart-collections-list) |
+| Metafield Product Images | [List](./REFERENCE.md#metafield-product-images-list) |
+| Customer Address | [List](./REFERENCE.md#customer-address-list), [Get](./REFERENCE.md#customer-address-get) |
+| Fulfillment Orders | [List](./REFERENCE.md#fulfillment-orders-list), [Get](./REFERENCE.md#fulfillment-orders-get) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Shopify API docs
+
+See the official [Shopify API reference](https://shopify.dev/docs/api/admin-rest).
+
+## Version information
+
+- **Package version:** 0.1.17
+- **Connector version:** 0.1.2
+- **Generated with Connector SDK commit SHA:** f6c6fca292b291b200b31e4056856465129ae703