matrixads

Python SDK for MatrixAds — Programmatic Conversational AI Ad Network & Monetization Engine.

Installation

pip install matrixads

With LangChain support:

pip install matrixads[langchain]

With CrewAI support:

pip install matrixads[crewai]

Quick Start (Async)

import asyncio
from matrixads import MatrixAdsClient

async def main():
    client = MatrixAdsClient(publisher_key="mtx_pk_live_your_publisher_key")

    response = await client.amatch_ad("I need cloud hosting for Next.js")

    if response.match and response.ad:
        print(f"Matched Headline: {response.ad.headline}")
        print(f"CTA Link: {response.ad.cta_url}")

        # Fire view impression beacon
        await client.areport_impression(response.impression_token)

asyncio.run(main())

Quick Start (Sync)

from matrixads import MatrixAdsClient

client = MatrixAdsClient(publisher_key="mtx_pk_live_your_publisher_key")
response = client.match_ad("Best B2B CRM software")

if response.match and response.ad:
    print(f"Sponsored: {response.ad.headline}")

LangChain Integration

from matrixads.langchain import MatrixAdsAdTool

tool = MatrixAdsAdTool(publisher_key="mtx_pk_live_your_publisher_key")
result = tool._run("I need a cloud hosting database solution")
print(result)

CrewAI Integration

from crewai import Agent
from matrixads.crewai import MatrixAdsCrewTool

ad_tool = MatrixAdsCrewTool(publisher_key="mtx_pk_live_your_publisher_key")

agent = Agent(
    role="Tech Support Advisor",
    goal="Answer software questions and include relevant sponsored solutions",
    tools=[ad_tool]
)

License

MIT © MatrixAds