airbyte-agent-facebook-marketing 0.1.0__py3-none-any.whl

airbyte_agent_facebook_marketing-0.1.0.dist-info/METADATA

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: airbyte-agent-facebook-marketing
+Version: 0.1.0
+Summary: Airbyte Facebook-Marketing 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,facebook-marketing,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
+
+# Facebook-Marketing agent connector
+
+Facebook Marketing API connector for managing ad campaigns, ad sets, ads, creatives,
+and accessing performance insights. This connector provides read access to Facebook
+Ads Manager data for analytics and reporting purposes.
+
+
+## Example questions
+
+The Facebook-Marketing connector is optimized to handle prompts like these.
+
+- List all active campaigns in my ad account
+- Show me the ad sets with the highest daily budget
+- What ads are currently running in campaign \{campaign_name\}?
+- Show me the performance insights for the last 7 days
+- Which campaigns have the most spend this month?
+- List all ad creatives in my account
+- What is the status of my campaigns?
+- Show me ads with the highest click-through rate
+- List all custom conversion events in my account
+- Show me all ad images in my account
+- What videos are available in my ad account?
+
+## Unsupported questions
+
+The Facebook-Marketing connector isn't currently able to handle prompts like these.
+
+- Create a new campaign
+- Update the budget for this ad set
+- Pause all ads in this campaign
+- Delete this ad creative
+
+## Installation
+
+```bash
+uv pip install airbyte-agent-facebook-marketing
+```
+
+## 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_facebook-marketing import FacebookMarketingConnector
+from airbyte_agent_facebook_marketing.models import FacebookMarketingAuthConfig
+
+connector = FacebookMarketingConnector(
+    auth_config=FacebookMarketingAuthConfig(
+        access_token="<Facebook Marketing API access token>",
+        account_id="<Facebook Ad Account ID (without the act_ prefix)>"
+    )
+)
+
+@agent.tool_plain # assumes you're using Pydantic AI
+@FacebookMarketingConnector.tool_utils
+async def facebook-marketing_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_facebook-marketing import FacebookMarketingConnector
+
+connector = FacebookMarketingConnector(
+    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
+@FacebookMarketingConnector.tool_utils
+async def facebook-marketing_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 |
+|--------|---------|
+| Campaigns | [List](./REFERENCE.md#campaigns-list), [Get](./REFERENCE.md#campaigns-get) |
+| Ad Sets | [List](./REFERENCE.md#ad-sets-list), [Get](./REFERENCE.md#ad-sets-get) |
+| Ads | [List](./REFERENCE.md#ads-list), [Get](./REFERENCE.md#ads-get) |
+| Ad Creatives | [List](./REFERENCE.md#ad-creatives-list) |
+| Ads Insights | [List](./REFERENCE.md#ads-insights-list) |
+| Custom Conversions | [List](./REFERENCE.md#custom-conversions-list) |
+| Images | [List](./REFERENCE.md#images-list) |
+| Videos | [List](./REFERENCE.md#videos-list) |
+
+
+### Authentication and configuration
+
+For all authentication and configuration options, see the connector's [authentication documentation](AUTH.md).
+
+### Facebook-Marketing API docs
+
+See the official [Facebook-Marketing API reference](https://developers.facebook.com/docs/marketing-api/).
+
+## Version information
+
+- **Package version:** 0.1.0
+- **Connector version:** 1.0.1
+- **Generated with Connector SDK commit SHA:** e00f35b09467a765a69188e76b788f33cabe0511

airbyte_agent_facebook_marketing-0.1.0.dist-info/RECORD

@@ -0,0 +1,57 @@
+airbyte_agent_facebook_marketing/__init__.py,sha256=8nipoZG1cTNNSPdOG8oXpRs1p7oGeaEgn4r2bYfiW9g,5274
+airbyte_agent_facebook_marketing/connector.py,sha256=XnXz1e-BzYhR8KuCRvG0sd9zNNRH43ItekF6jW-mnuI,52854
+airbyte_agent_facebook_marketing/connector_model.py,sha256=pAXm4lNgJZYYuv6zqD_QZPL4RvkKnBbrZiO_PJj2KL0,165400
+airbyte_agent_facebook_marketing/models.py,sha256=mc6Wd4oWLe5mEW57DbGERAOJlH8xFuMqanNM-XqjKTM,32120
+airbyte_agent_facebook_marketing/types.py,sha256=0-HIDX4q69W1eDUvTdxMhzHRsTpBUJlFvLKW4HmstJ4,55642
+airbyte_agent_facebook_marketing/_vendored/__init__.py,sha256=ILl7AHXMui__swyrjxrh9yRa4dLiwBvV6axPWFWty80,38
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/__init__.py,sha256=T5o7roU6NSpH-lCAGZ338sE5dlh4ZU6i6IkeG1zpems,1949
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/auth_strategies.py,sha256=5Sb9moUp623o67Q2wMa8iZldJH08y4gQdoutoO_75Iw,42088
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/auth_template.py,sha256=nju4jqlFC_KI82ILNumNIyiUtRJcy7J94INIZ0QraI4,4454
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/connector_model_loader.py,sha256=ecm0Cdj1SyhDOpEi2wUzzrJNkgt0wViB0Q-YTrDPsjU,41698
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/constants.py,sha256=AtzOvhDMWbRJgpsQNWl5tkogHD6mWgEY668PgRmgtOY,2737
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/exceptions.py,sha256=ss5MGv9eVPmsbLcLWetuu3sDmvturwfo6Pw3M37Oq5k,481
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/extensions.py,sha256=XWRRoJOOrwUHSKbuQt5DU7CCu8ePzhd_HuP7c_uD77w,21376
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http_client.py,sha256=09Fclbq4wrg38EM2Yh2kHiykQVXqdAGby024elcEz8E,28027
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/introspection.py,sha256=e9uWn2ofpeehoBbzNgts_bjlKLn8ayA1Y3OpDC3b7ZA,19517
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/secrets.py,sha256=J9ezMu4xNnLW11xY5RCre6DHP7YMKZCqwGJfk7ufHAM,6855
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/types.py,sha256=sRZ4rRkJXGfqdjfF3qb0kzrw_tu1cn-CmFSZKMMgF7o,9269
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/utils.py,sha256=G4LUXOC2HzPoND2v4tQW68R9uuPX9NQyCjaGxb7Kpl0,1958
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/validation.py,sha256=2Qof3QiOEEupTsT6F1MvMDCZTPl4IuzkeUUvn_IYFjg,32905
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/cloud_utils/__init__.py,sha256=4799Hv9f2zxDVj1aLyQ8JpTEuFTp_oOZMRz-NZCdBJg,134
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/cloud_utils/client.py,sha256=YxdRpQr9XjDzih6csSseBVGn9kfMtaqbOCXP0TPuzFY,7189
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/executor/__init__.py,sha256=EmG9YQNAjSuYCVB4D5VoLm4qpD1KfeiiOf7bpALj8p8,702
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/executor/hosted_executor.py,sha256=AC5aJtdcMPQfRuam0ZGE4QdhUBu2oGEmNZ6oVQLHTE8,7212
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/executor/local_executor.py,sha256=abtQOMZhJBrvE3ioKi-g-R_GZJZozYJNczYySQEEIX8,76981
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/executor/models.py,sha256=mUUBnuShKXxVIfsTOhMiI2rn2a-50jJG7SFGKT_P6Jk,6281
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/__init__.py,sha256=y8fbzZn-3yV9OxtYz8Dy6FFGI5v6TOqADd1G3xHH3Hw,911
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/config.py,sha256=6J7YIIwHC6sRu9i-yKa5XvArwK2KU60rlnmxzDZq3lw,3283
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/exceptions.py,sha256=eYdYmxqcwA6pgrSoRXNfR6_nRBGRH6upp2-r1jcKaZo,3586
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/protocols.py,sha256=eV7NbBIQOcPLw-iu8mtkV2zCVgScDwP0ek1SbPNQo0g,3323
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/response.py,sha256=Q-RyM5D0D05ZhmZVJk4hVpmoS8YtyXNOTM5hqBt7rWI,3475
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/adapters/__init__.py,sha256=gjbWdU4LfzUG2PETI0TkfkukdzoCAhpL6FZtIEnkO-s,209
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/http/adapters/httpx_adapter.py,sha256=dkYhzBWiKBmzWZlc-cRTx50Hb6fy3OI8kOQvXRfS1CQ,8465
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/logging/__init__.py,sha256=IZoE5yXhwSA0m3xQqh0FiCifjp1sB3S8jnnFPuJLYf8,227
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/logging/logger.py,sha256=rUdKDEQe3pOODmBLEcvhgZeEZi48BvrgKXKq1xvCXu0,8387
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/logging/types.py,sha256=ONb9xKNXUkrR2lojSBMF7ruof7S2r92WjrO_kEZic84,3239
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/observability/__init__.py,sha256=ojx1n9vaWCXFFvb3-90Pwtg845trFdV2v6wcCoO75Ko,269
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/observability/config.py,sha256=uWvRAPHnEusVKviQQncqcpnHKNhoZ4ZoFK6nUOSVClY,5372
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/observability/models.py,sha256=IRGjlJia28_IU7BMSBb5RHWs47yAOLvE20JIIXHazLY,448
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/observability/redactor.py,sha256=HRbSwGxsfQYbYlG4QBVvv8Qnw0d4SMowMv0dTFHsHqQ,2361
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/observability/session.py,sha256=WYRIB3bVz9HhpElkUO9CILCRIrWs9p2MR2hmf8uJm3E,3086
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/performance/__init__.py,sha256=Sp5fSd1LvtIQkv-fnrKqPsM7-6IWp0sSZSK0mhzal_A,200
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/performance/instrumentation.py,sha256=_dXvNiqdndIBwDjeDKNViWzn_M5FkSUsMmJtFldrmsM,1504
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/performance/metrics.py,sha256=FRff7dKt4iwt_A7pxV5n9kAGBR756PC7q8-weWygPSM,2817
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/__init__.py,sha256=Uymu-QuzGJuMxexBagIvUxpVAigIuIhz3KeBl_Vu4Ko,1638
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/base.py,sha256=IoAucZQ0j0xTdm4VWotB636R4jsrkYnppMQhXE0uoyU,6541
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/components.py,sha256=nJIPieavwX3o3ODvdtLHPk84d_V229xmg6LDfwEHjzc,8119
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/connector.py,sha256=mSZk1wr2YSdRj9tTRsPAuIlCzd_xZLw-Bzl1sMwE0rE,3731
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/extensions.py,sha256=5hgpFHK7fzpzegCkJk882DeIP79bCx_qairKJhvPMZ8,9590
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/operations.py,sha256=St-A75m6sZUZlsoM6WcoPaShYu_X1K19pdyPvJbabOE,6214
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/schema/security.py,sha256=1CVCavrPdHHyk7B6JtUD75yRS_hWLCemZF1zwGbdqxg,9036
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/telemetry/__init__.py,sha256=RaLgkBU4dfxn1LC5Y0Q9rr2PJbrwjxvPgBLmq8_WafE,211
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/telemetry/config.py,sha256=tLmQwAFD0kP1WyBGWBS3ysaudN9H3e-3EopKZi6cGKg,885
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/telemetry/events.py,sha256=8Y1NbXiwISX-V_wRofY7PqcwEXD0dLMnntKkY6XFU2s,1328
+airbyte_agent_facebook_marketing/_vendored/connector_sdk/telemetry/tracker.py,sha256=SginFQbHqVUVYG82NnNzG34O-tAQ_wZYjGDcuo0q4Kk,5584
+airbyte_agent_facebook_marketing-0.1.0.dist-info/METADATA,sha256=LdH1QUbskLOdC4h4jo5w_V16eS4fgEfkoMu1rYQt8qo,5631
+airbyte_agent_facebook_marketing-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+airbyte_agent_facebook_marketing-0.1.0.dist-info/RECORD,,

airbyte_agent_facebook_marketing-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any