airbyte-agent-amazon-ads 0.1.0__tar.gz

airbyte_agent_amazon_ads-0.1.0/.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_amazon_ads-0.1.0/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Amazon Ads changelog
+
+## [0.1.0] - 2026-01-21
+- Updated connector definition (YAML version 1.0.1)
+- Source commit: 5fbc94c3
+- SDK version: 0.1.0

airbyte_agent_amazon_ads-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-amazon-ads
+Version: 0.1.0
+Summary: Airbyte Amazon-Ads 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,amazon-ads,api,connector,data-integration,llm,mcp
+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
+
+# Amazon-Ads agent connector
+
+Amazon Ads is Amazon's advertising platform that enables sellers and vendors to promote their
+products across Amazon's marketplace. This connector provides access to advertising profiles
+for managing and analyzing advertising campaigns across different marketplaces.
+
+
+## Example questions
+
+The Amazon-Ads connector is optimized to handle prompts like these.
+
+- List all my advertising profiles across marketplaces
+- Show me the profiles for my seller accounts
+- What marketplaces do I have advertising profiles in?
+- List all portfolios for a specific profile
+- Show me all sponsored product campaigns
+- What campaigns are currently enabled?
+- Find campaigns with a specific targeting type
+
+## Unsupported questions
+
+The Amazon-Ads connector isn't currently able to handle prompts like these.
+
+- Create a new advertising campaign
+- Update my campaign budget
+- Delete an ad group
+- Generate a performance report
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-amazon-ads
+```
+
+## Usage
+
+```python
+from airbyte_agent_amazon_ads import AmazonAdsConnector, AmazonAdsAuthConfig
+
+connector = AmazonAdsConnector(
+  auth_config=AmazonAdsAuthConfig(
+    client_id="...",
+    client_secret="...",
+    refresh_token="..."
+  )
+)
+result = await connector.profiles.list()
+```
+
+
+## Full documentation
+
+This connector supports the following entities and actions.
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
+| Portfolios | [List](./REFERENCE.md#portfolios-list), [Get](./REFERENCE.md#portfolios-get) |
+| Sponsored Product Campaigns | [List](./REFERENCE.md#sponsored-product-campaigns-list), [Get](./REFERENCE.md#sponsored-product-campaigns-get) |
+
+
+For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+
+For the service's official API docs, see the [Amazon-Ads API reference](https://advertising.amazon.com/API/docs/en-us).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** 5fbc94c3c665f3c1f39576555fc0e9537bc3f2fa

airbyte_agent_amazon_ads-0.1.0/README.md

@@ -0,0 +1,70 @@
+# Amazon-Ads agent connector
+
+Amazon Ads is Amazon's advertising platform that enables sellers and vendors to promote their
+products across Amazon's marketplace. This connector provides access to advertising profiles
+for managing and analyzing advertising campaigns across different marketplaces.
+
+
+## Example questions
+
+The Amazon-Ads connector is optimized to handle prompts like these.
+
+- List all my advertising profiles across marketplaces
+- Show me the profiles for my seller accounts
+- What marketplaces do I have advertising profiles in?
+- List all portfolios for a specific profile
+- Show me all sponsored product campaigns
+- What campaigns are currently enabled?
+- Find campaigns with a specific targeting type
+
+## Unsupported questions
+
+The Amazon-Ads connector isn't currently able to handle prompts like these.
+
+- Create a new advertising campaign
+- Update my campaign budget
+- Delete an ad group
+- Generate a performance report
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-amazon-ads
+```
+
+## Usage
+
+```python
+from airbyte_agent_amazon_ads import AmazonAdsConnector, AmazonAdsAuthConfig
+
+connector = AmazonAdsConnector(
+  auth_config=AmazonAdsAuthConfig(
+    client_id="...",
+    client_secret="...",
+    refresh_token="..."
+  )
+)
+result = await connector.profiles.list()
+```
+
+
+## Full documentation
+
+This connector supports the following entities and actions.
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](./REFERENCE.md#profiles-list), [Get](./REFERENCE.md#profiles-get) |
+| Portfolios | [List](./REFERENCE.md#portfolios-list), [Get](./REFERENCE.md#portfolios-get) |
+| Sponsored Product Campaigns | [List](./REFERENCE.md#sponsored-product-campaigns-list), [Get](./REFERENCE.md#sponsored-product-campaigns-get) |
+
+
+For detailed documentation on available actions and parameters, see this connector's [full reference documentation](./REFERENCE.md).
+
+For the service's official API docs, see the [Amazon-Ads API reference](https://advertising.amazon.com/API/docs/en-us).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** 5fbc94c3c665f3c1f39576555fc0e9537bc3f2fa

airbyte_agent_amazon_ads-0.1.0/REFERENCE.md

@@ -0,0 +1,373 @@
+# Amazon-Ads full reference
+
+This is the full reference documentation for the Amazon-Ads agent connector.
+
+## Supported entities and actions
+
+The Amazon-Ads connector supports the following entities and actions.
+
+| Entity | Actions |
+|--------|---------|
+| Profiles | [List](#profiles-list), [Get](#profiles-get) |
+| Portfolios | [List](#portfolios-list), [Get](#portfolios-get) |
+| Sponsored Product Campaigns | [List](#sponsored-product-campaigns-list), [Get](#sponsored-product-campaigns-get) |
+
+### Profiles
+
+#### Profiles List
+
+Returns a list of advertising profiles associated with the authenticated user.
+Profiles represent an advertiser's account in a specific marketplace. Advertisers
+may have a single profile if they advertise in only one marketplace, or a separate
+profile for each marketplace if they advertise regionally or globally.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.profiles.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "profiles",
+    "action": "list"
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `profileTypeFilter` | `string` | No | Filter profiles by type. Comma-separated list of profile types.
+Valid values: seller, vendor, agency
+ |
+
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `profileId` | `integer` |  |
+| `countryCode` | `string \| null` |  |
+| `currencyCode` | `string \| null` |  |
+| `dailyBudget` | `number \| null` |  |
+| `timezone` | `string \| null` |  |
+| `accountInfo` | `object \| any` |  |
+
+
+</details>
+
+#### Profiles Get
+
+Retrieves a single advertising profile by its ID. The profile contains
+information about the advertiser's account in a specific marketplace.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.profiles.get(
+    profile_id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "profiles",
+    "action": "get",
+    "params": {
+        "profileId": 0
+    }
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `profileId` | `integer` | Yes | The unique identifier of the profile |
+
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `profileId` | `integer` |  |
+| `countryCode` | `string \| null` |  |
+| `currencyCode` | `string \| null` |  |
+| `dailyBudget` | `number \| null` |  |
+| `timezone` | `string \| null` |  |
+| `accountInfo` | `object \| any` |  |
+
+
+</details>
+
+### Portfolios
+
+#### Portfolios List
+
+Returns a list of portfolios for the specified profile. Portfolios are used to
+group campaigns together for organizational and budget management purposes.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.portfolios.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "portfolios",
+    "action": "list"
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `includeExtendedDataFields` | `string` | No | Whether to include extended data fields in the response |
+
+
+#### Portfolios Get
+
+Retrieves a single portfolio by its ID using the v2 API.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.portfolios.get(
+    portfolio_id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "portfolios",
+    "action": "get",
+    "params": {
+        "portfolioId": 0
+    }
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `portfolioId` | `integer` | Yes | The unique identifier of the portfolio |
+
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `portfolioId` | `string \| integer` |  |
+| `name` | `string \| null` |  |
+| `budget` | `object \| any` |  |
+| `inBudget` | `boolean \| null` |  |
+| `state` | `string \| null` |  |
+| `creationDate` | `integer \| null` |  |
+| `lastUpdatedDate` | `integer \| null` |  |
+| `servingStatus` | `string \| null` |  |
+
+
+</details>
+
+### Sponsored Product Campaigns
+
+#### Sponsored Product Campaigns List
+
+Returns a list of sponsored product campaigns for the specified profile.
+Sponsored Products campaigns promote individual product listings on Amazon.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.sponsored_product_campaigns.list()
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "sponsored_product_campaigns",
+    "action": "list"
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `stateFilter` | `object` | No |  |
+| `stateFilter.include` | `string` | No | Comma-separated list of states to include (enabled, paused, archived) |
+| `maxResults` | `integer` | No | Maximum number of results to return |
+| `nextToken` | `string` | No | Token for pagination |
+
+
+#### Sponsored Product Campaigns Get
+
+Retrieves a single sponsored product campaign by its ID using the v2 API.
+
+
+**Python SDK**
+
+```python
+await amazon_ads.sponsored_product_campaigns.get(
+    campaign_id=0
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/connectors/sources/{your_source_id}/execute' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+    "entity": "sponsored_product_campaigns",
+    "action": "get",
+    "params": {
+        "campaignId": 0
+    }
+}'
+```
+
+
+**Parameters**
+
+| Parameter Name | Type | Required | Description |
+|----------------|------|----------|-------------|
+| `campaignId` | `integer` | Yes | The unique identifier of the campaign |
+
+
+<details>
+<summary><b>Response Schema</b></summary>
+
+**Records**
+
+| Field Name | Type | Description |
+|------------|------|-------------|
+| `campaignId` | `string \| integer` |  |
+| `portfolioId` | `string \| integer \| any` |  |
+| `name` | `string \| null` |  |
+| `campaignType` | `string \| null` |  |
+| `tags` | `object \| null` |  |
+| `targetingType` | `string \| null` |  |
+| `premiumBidAdjustment` | `boolean \| null` |  |
+| `state` | `string \| null` |  |
+| `dynamicBidding` | `object \| any` |  |
+| `bidding` | `object \| any` |  |
+| `startDate` | `string \| null` |  |
+| `endDate` | `string \| null` |  |
+| `dailyBudget` | `number \| null` |  |
+| `budget` | `object \| any` |  |
+| `extendedData` | `object \| null` |  |
+| `marketplaceBudgetAllocation` | `string \| null` |  |
+| `offAmazonSettings` | `object \| null` |  |
+
+
+</details>
+
+
+
+## Configuration
+
+The Amazon-Ads 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 |
+|----------|------|----------|---------|-------------|
+| `region_url` | `string` | Yes | https://advertising-api.amazon.com | The Amazon Ads API endpoint URL based on region:
+- NA (North America): https://advertising-api.amazon.com
+- EU (Europe): https://advertising-api-eu.amazon.com
+- FE (Far East): https://advertising-api-fe.amazon.com
+ |
+
+
+## Authentication
+
+The Amazon-Ads connector supports the following authentication methods.
+
+
+### OAuth2 Authentication
+
+| Field Name | Type | Required | Description |
+|------------|------|----------|-------------|
+| `client_id` | `str` | Yes | The client ID of your Amazon Ads API application |
+| `client_secret` | `str` | Yes | The client secret of your Amazon Ads API application |
+| `refresh_token` | `str` | Yes | The refresh token obtained from the OAuth authorization flow |
+
+#### Example
+
+**Python SDK**
+
+```python
+AmazonAdsConnector(
+  auth_config=AmazonAdsAuthConfig(
+    client_id="<The client ID of your Amazon Ads API application>",
+    client_secret="<The client secret of your Amazon Ads API application>",
+    refresh_token="<The refresh token obtained from the OAuth authorization flow>"
+  )
+)
+```
+
+**API**
+
+```bash
+curl --location 'https://api.airbyte.ai/api/v1/integrations/sources' \
+--header 'Content-Type: application/json' \
+--header 'Authorization: Bearer {your_auth_token}' \
+--data '{
+  "workspace_id": "{your_workspace_id}",
+  "source_template_id": "{source_template_id}",
+  "auth_config": {
+    "client_id": "<The client ID of your Amazon Ads API application>",
+    "client_secret": "<The client secret of your Amazon Ads API application>",
+    "refresh_token": "<The refresh token obtained from the OAuth authorization flow>"
+  },
+  "name": "My Amazon-Ads Connector"
+}'
+```
+

airbyte_agent_amazon_ads-0.1.0/airbyte_agent_amazon_ads/__init__.py

@@ -0,0 +1,57 @@
+"""
+Blessed Amazon-Ads connector for Airbyte SDK.
+
+Auto-generated from OpenAPI specification.
+"""
+
+from .connector import AmazonAdsConnector
+from .models import (
+    AmazonAdsAuthConfig,
+    Profile,
+    AccountInfo,
+    Portfolio,
+    PortfolioBudget,
+    SponsoredProductCampaign,
+    DynamicBiddingPlacementbiddingItem,
+    DynamicBidding,
+    CampaignBudget,
+    AmazonAdsExecuteResult,
+    AmazonAdsExecuteResultWithMeta,
+    ProfilesListResult,
+    PortfoliosListResult,
+    SponsoredProductCampaignsListResult
+)
+from .types import (
+    SponsoredProductCampaignsListParamsStatefilter,
+    ProfilesListParams,
+    ProfilesGetParams,
+    PortfoliosListParams,
+    PortfoliosGetParams,
+    SponsoredProductCampaignsListParams,
+    SponsoredProductCampaignsGetParams
+)
+
+__all__ = [
+    "AmazonAdsConnector",
+    "AmazonAdsAuthConfig",
+    "Profile",
+    "AccountInfo",
+    "Portfolio",
+    "PortfolioBudget",
+    "SponsoredProductCampaign",
+    "DynamicBiddingPlacementbiddingItem",
+    "DynamicBidding",
+    "CampaignBudget",
+    "AmazonAdsExecuteResult",
+    "AmazonAdsExecuteResultWithMeta",
+    "ProfilesListResult",
+    "PortfoliosListResult",
+    "SponsoredProductCampaignsListResult",
+    "SponsoredProductCampaignsListParamsStatefilter",
+    "ProfilesListParams",
+    "ProfilesGetParams",
+    "PortfoliosListParams",
+    "PortfoliosGetParams",
+    "SponsoredProductCampaignsListParams",
+    "SponsoredProductCampaignsGetParams",
+]

airbyte_agent_amazon_ads-0.1.0/airbyte_agent_amazon_ads/_vendored/__init__.py

@@ -0,0 +1 @@
+"""Vendored connector-sdk runtime."""