meta-ads-mcp 0.7.2__py3-none-any.whl → 0.7.3__py3-none-any.whl

meta_ads_mcp/__init__.py

@@ -7,7 +7,7 @@ with the Claude LLM.
 
 from meta_ads_mcp.core.server import main
 
-__version__ = "0.7.2"
+__version__ = "0.7.3"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/ads_library.py

@@ -1,69 +1,74 @@
 """Adds Library-related functionality for Meta Ads API."""
 
 import json
+import os
 from typing import Optional, List, Dict, Any
 from .api import meta_api_tool, make_api_request
 from .server import mcp_server
 
 
-@mcp_server.tool()
-@meta_api_tool
-async def search_ads_archive(
-    access_token: str = None,
-    search_terms: str = None,
-    ad_type: str = "ALL",
-    ad_reached_countries: List[str] = None,
-    limit: int = 25,  # Default limit, adjust as needed
-    fields: str = "ad_creation_time,ad_creative_body,ad_creative_link_caption,ad_creative_link_description,ad_creative_link_title,ad_delivery_start_time,ad_delivery_stop_time,ad_snapshot_url,currency,demographic_distribution,funding_entity,impressions,page_id,page_name,publisher_platform,region_distribution,spend"
-) -> str:
-    """
-    Search the Facebook Ads Library archive.
+# Only register the search_ads_archive function if the environment variable is NOT set
+DISABLE_ADS_LIBRARY = bool(os.environ.get("META_ADS_DISABLE_ADS_LIBRARY", ""))
 
-    Args:
-        access_token: Meta API access token (optional - will use cached token if not provided).
-        search_terms: The search query for ads.
-        ad_type: Type of ads to search for (e.g., POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, ALL).
-        ad_reached_countries: List of country codes (e.g., ["US", "GB"]).
-        limit: Maximum number of ads to return.
-        fields: Comma-separated string of fields to retrieve for each ad.
+if not DISABLE_ADS_LIBRARY:
+    @mcp_server.tool()
+    @meta_api_tool
+    async def search_ads_archive(
+        access_token: str = None,
+        search_terms: str = None,
+        ad_type: str = "ALL",
+        ad_reached_countries: List[str] = None,
+        limit: int = 25,  # Default limit, adjust as needed
+        fields: str = "ad_creation_time,ad_creative_body,ad_creative_link_caption,ad_creative_link_description,ad_creative_link_title,ad_delivery_start_time,ad_delivery_stop_time,ad_snapshot_url,currency,demographic_distribution,funding_entity,impressions,page_id,page_name,publisher_platform,region_distribution,spend"
+    ) -> str:
+        """
+        Search the Facebook Ads Library archive.
 
-    Example Usage via curl equivalent:
-        curl -G \\
-        -d "search_terms='california'" \\
-        -d "ad_type=POLITICAL_AND_ISSUE_ADS" \\
-        -d "ad_reached_countries=['US']" \\
-        -d "fields=ad_snapshot_url,spend" \\
-        -d "access_token=<ACCESS_TOKEN>" \\
-        "https://graph.facebook.com/<API_VERSION>/ads_archive"
-    """
-    if not access_token:
-        # Attempt to get token implicitly if not provided - meta_api_tool handles this
-        pass
+        Args:
+            access_token: Meta API access token (optional - will use cached token if not provided).
+            search_terms: The search query for ads.
+            ad_type: Type of ads to search for (e.g., POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, ALL).
+            ad_reached_countries: List of country codes (e.g., ["US", "GB"]).
+            limit: Maximum number of ads to return.
+            fields: Comma-separated string of fields to retrieve for each ad.
 
-    if not search_terms:
-        return json.dumps({"error": "search_terms parameter is required"}, indent=2)
+        Example Usage via curl equivalent:
+            curl -G \\
+            -d "search_terms='california'" \\
+            -d "ad_type=POLITICAL_AND_ISSUE_ADS" \\
+            -d "ad_reached_countries=['US']" \\
+            -d "fields=ad_snapshot_url,spend" \\
+            -d "access_token=<ACCESS_TOKEN>" \\
+            "https://graph.facebook.com/<API_VERSION>/ads_archive"
+        """
+        if not access_token:
+            # Attempt to get token implicitly if not provided - meta_api_tool handles this
+            pass
 
-    if not ad_reached_countries:
-        return json.dumps({"error": "ad_reached_countries parameter is required"}, indent=2)
+        if not search_terms:
+            return json.dumps({"error": "search_terms parameter is required"}, indent=2)
 
-    endpoint = "ads_archive"
-    params = {
-        "search_terms": search_terms,
-        "ad_type": ad_type,
-        "ad_reached_countries": json.dumps(ad_reached_countries), # API expects a JSON array string
-        "limit": limit,
-        "fields": fields,
-    }
+        if not ad_reached_countries:
+            return json.dumps({"error": "ad_reached_countries parameter is required"}, indent=2)
 
-    try:
-        data = await make_api_request(endpoint, access_token, params, method="GET")
-        return json.dumps(data, indent=2)
-    except Exception as e:
-        error_msg = str(e)
-        # Consider logging the full error for debugging
-        # print(f"Error calling Ads Library API: {error_msg}")
-        return json.dumps({
-            "error": "Failed to search ads archive",
-            "details": error_msg,
-            "params_sent": {k: v for k, v in params.items() if k != 'access_token'} # Avoid logging token
-        }, indent=2) 
+        endpoint = "ads_archive"
+        params = {
+            "search_terms": search_terms,
+            "ad_type": ad_type,
+            "ad_reached_countries": json.dumps(ad_reached_countries), # API expects a JSON array string
+            "limit": limit,
+            "fields": fields,
+        }
+
+        try:
+            data = await make_api_request(endpoint, access_token, params, method="GET")
+            return json.dumps(data, indent=2)
+        except Exception as e:
+            error_msg = str(e)
+            # Consider logging the full error for debugging
+            # print(f"Error calling Ads Library API: {error_msg}")
+            return json.dumps({
+                "error": "Failed to search ads archive",
+                "details": error_msg,
+                "params_sent": {k: v for k, v in params.items() if k != 'access_token'} # Avoid logging token
+            }, indent=2) 

{meta_ads_mcp-0.7.2.dist-info → meta_ads_mcp-0.7.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.7.2
+Version: 0.7.3
 Summary: Model Context Protocol (MCP) plugin for interacting with Meta Ads API
 Project-URL: Homepage, https://github.com/pipeboard-co/meta-ads-mcp
 Project-URL: Bug Tracker, https://github.com/pipeboard-co/meta-ads-mcp/issues

{meta_ads_mcp-0.7.2.dist-info → meta_ads_mcp-0.7.3.dist-info}/RECORD

@@ -1,9 +1,9 @@
-meta_ads_mcp/__init__.py,sha256=KwWEwtUuoU8IdDlVrrrmoG5dF51_f0RcetZ8dUiTwRA,1492
+meta_ads_mcp/__init__.py,sha256=zoHok7v3IrW0q7qRG2A-7SKBUairjLpMXZTtDJsvpxY,1492
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=IHBUfLTQW44VLbH_gZDT83nqzGrVWZ0l7FG4P3bp_bU,1706
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
 meta_ads_mcp/core/ads.py,sha256=aaK70mgfhBJRXr4cdkKag5mjYzvHuHpRttJvTMzPk4Y,36156
-meta_ads_mcp/core/ads_library.py,sha256=onStn9UkRqYDC60gOPS-iKDtP1plz6DygUb7hUZ0Jw8,2807
+meta_ads_mcp/core/ads_library.py,sha256=BBGVbtjO5eFV42iiY3XPU-wIV8HupzUKpHgPBrydSvU,3232
 meta_ads_mcp/core/adsets.py,sha256=k76rm3rkhEebUzvBnM_QaVktrzGTKvTJOtWbBd6s3i8,10399
 meta_ads_mcp/core/api.py,sha256=aAzM6Q75VQOFXtr5D-mDmBRhxWK4wsiODsJYnR3mpDI,14994
 meta_ads_mcp/core/auth.py,sha256=H-0s0O2fLo14rmi81Hh5S64pyRl1HS7dm9Q_8UCa3Jg,21622
@@ -21,8 +21,8 @@ meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0
 meta_ads_mcp/core/server.py,sha256=WhbAag7xdhbGcp7rnU4sKhqXJ8Slapa_ba3T23Yp_2U,17889
 meta_ads_mcp/core/targeting.py,sha256=3HW1qirEdwaQurlBZGenbIwawcb5J06ghJKRfgu9ZEs,6318
 meta_ads_mcp/core/utils.py,sha256=ofKUhyo-5SZoJVuBeTVFPPQCffk0UKpwmDMrd8qQxNc,8715
-meta_ads_mcp-0.7.2.dist-info/METADATA,sha256=qE7hnGdcACq3_MRBnFb_kGV-gJzMes_d1AJjPx8u01s,20409
-meta_ads_mcp-0.7.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.7.2.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.7.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.7.2.dist-info/RECORD,,
+meta_ads_mcp-0.7.3.dist-info/METADATA,sha256=VIUGrJrlUcsNKtHH45dK7H0CXn3YuK87_T4BCdM_0UA,20409
+meta_ads_mcp-0.7.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.7.3.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.7.3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.7.3.dist-info/RECORD,,