meta-ads-mcp 0.4.5__py3-none-any.whl → 0.4.7__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.4.5"
+__version__ = "0.4.7"
 
 __all__ = [
     'get_ad_accounts',

meta_ads_mcp/core/ads.py

@@ -10,7 +10,7 @@ import time
 
 from .api import meta_api_tool, make_api_request
 from .accounts import get_ad_accounts
-from .utils import download_image, try_multiple_download_methods, ad_creative_images
+from .utils import download_image, try_multiple_download_methods, ad_creative_images, extract_creative_image_urls
 from .server import mcp_server
 
 
@@ -179,7 +179,7 @@ async def get_ad_creatives(access_token: str = None, ad_id: str = None) -> str:
     # Add image URLs for direct viewing if available
     if 'data' in data:
         for creative in data['data']:
-            creative['image_urls_for_viewing'] = ad_creative_images(creative)
+            creative['image_urls_for_viewing'] = extract_creative_image_urls(creative)
 
     return json.dumps(data, indent=2)
 
@@ -806,11 +806,74 @@ async def get_account_pages(access_token: str = None, account_id: str = None) ->
                 if page_details["data"]:
                     return json.dumps(page_details, indent=2)
         
+        # Approach 4: Extract page IDs from tracking_specs in ads
+        # Inspired by praveen92y's implementation for robust page detection
+        # This approach is often the most reliable as confirmed by community feedback
+        endpoint = f"{account_id}/ads"
+        params = {
+            "fields": "id,name,adset_id,campaign_id,status,creative,created_time,updated_time,bid_amount,conversion_domain,tracking_specs",
+            "limit": 100
+        }
+        
+        tracking_ads_data = await make_api_request(endpoint, access_token, params)
+        
+        tracking_page_ids = set()
+        if "data" in tracking_ads_data:
+            for ad in tracking_ads_data.get("data", []):
+                tracking_specs = ad.get("tracking_specs", [])
+                if isinstance(tracking_specs, list):
+                    for spec in tracking_specs:
+                        # If 'page' key exists, add all page IDs
+                        if isinstance(spec, dict) and "page" in spec:
+                            page_list = spec["page"]
+                            if isinstance(page_list, list):
+                                for page_id in page_list:
+                                    # Validate page ID format (should be numeric string)
+                                    if isinstance(page_id, (str, int)) and str(page_id).isdigit():
+                                        tracking_page_ids.add(str(page_id))
+        
+        if tracking_page_ids:
+            page_details = {"data": [], "source": "tracking_specs", "note": "Page IDs extracted from active ads - these are the most reliable for ad creation"}
+            for page_id in tracking_page_ids:
+                page_endpoint = f"{page_id}"
+                page_params = {
+                    "fields": "id,name,username,category,fan_count,link,verification_status,picture"
+                }
+                
+                page_data = await make_api_request(page_endpoint, access_token, page_params)
+                if "id" in page_data:
+                    # Add additional context about this page ID being suitable for ads
+                    page_data["_meta"] = {
+                        "suitable_for_ads": True,
+                        "found_in_tracking_specs": True,
+                        "recommended_for_create_ad_creative": True
+                    }
+                    page_details["data"].append(page_data)
+                else:
+                    page_details["data"].append({
+                        "id": page_id, 
+                        "error": "Page details not found",
+                        "_meta": {
+                            "suitable_for_ads": True,
+                            "found_in_tracking_specs": True,
+                            "note": "Page ID exists in ads but details not accessible - you can still use this ID for ad creation"
+                        }
+                    })
+            
+            if page_details["data"]:
+                return json.dumps(page_details, indent=2)
+        
         # If all approaches failed, return empty data with a message
         return json.dumps({
             "data": [],
-            "message": "No pages found associated with this account",
-            "suggestion": "You may need to create a page or provide a page_id explicitly when creating ads"
+            "message": "No pages found associated with this account using automated methods",
+            "troubleshooting": {
+                "suggestion_1": "If you have existing ads, run 'get_ads' and look for page IDs in the 'tracking_specs' field",
+                "suggestion_2": "Use the exact page ID from existing ads' tracking_specs for creating new ad creatives",
+                "suggestion_3": "Verify your page ID format - it should be a numeric string (e.g., '123456789')",
+                "suggestion_4": "Check for digit transpositions or formatting errors in your page ID"
+            },
+            "note": "Based on community feedback, page IDs from existing ads' tracking_specs are the most reliable for ad creation"
         }, indent=2)
         
     except Exception as e:

meta_ads_mcp/core/utils.py

@@ -1,6 +1,6 @@
 """Utility functions for Meta Ads API."""
 
-from typing import Optional, Dict, Any
+from typing import Optional, Dict, Any, List
 import httpx
 import io
 from PIL import Image as PILImage
@@ -74,6 +74,64 @@ logger = setup_logging()
 # Global store for ad creative images
 ad_creative_images = {}
 
+
+def extract_creative_image_urls(creative: Dict[str, Any]) -> List[str]:
+    """
+    Extract image URLs from a creative object for direct viewing.
+    
+    Args:
+        creative: Meta Ads creative object
+        
+    Returns:
+        List of image URLs found in the creative
+    """
+    image_urls = []
+    
+    # Check for direct image_url field
+    if "image_url" in creative and creative["image_url"]:
+        image_urls.append(creative["image_url"])
+    
+    # Check for thumbnail_url field
+    if "thumbnail_url" in creative and creative["thumbnail_url"]:
+        image_urls.append(creative["thumbnail_url"])
+    
+    # Check object_story_spec for image URLs
+    if "object_story_spec" in creative:
+        story_spec = creative["object_story_spec"]
+        
+        # Check link_data for image fields
+        if "link_data" in story_spec:
+            link_data = story_spec["link_data"]
+            
+            # Check for picture field
+            if "picture" in link_data and link_data["picture"]:
+                image_urls.append(link_data["picture"])
+                
+            # Check for image_url field in link_data
+            if "image_url" in link_data and link_data["image_url"]:
+                image_urls.append(link_data["image_url"])
+        
+        # Check video_data for thumbnail (if present)
+        if "video_data" in story_spec and "image_url" in story_spec["video_data"]:
+            image_urls.append(story_spec["video_data"]["image_url"])
+    
+    # Check asset_feed_spec for multiple images
+    if "asset_feed_spec" in creative and "images" in creative["asset_feed_spec"]:
+        for image in creative["asset_feed_spec"]["images"]:
+            if "url" in image and image["url"]:
+                image_urls.append(image["url"])
+    
+    # Remove duplicates while preserving order
+    seen = set()
+    unique_urls = []
+    for url in image_urls:
+        if url not in seen:
+            seen.add(url)
+            unique_urls.append(url)
+    
+    return unique_urls
+
+
 async def download_image(url: str) -> Optional[bytes]:
     """
     Download an image from a URL.

{meta_ads_mcp-0.4.5.dist-info → meta_ads_mcp-0.4.7.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: meta-ads-mcp
-Version: 0.4.5
+Version: 0.4.7
 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.4.5.dist-info → meta_ads_mcp-0.4.7.dist-info}/RECORD

@@ -1,8 +1,8 @@
-meta_ads_mcp/__init__.py,sha256=AxnyJlgEJff8wT7T97juuWAkqoDQ9ekMbxMCCZx4Btk,1182
+meta_ads_mcp/__init__.py,sha256=xGsc5RhOEUMCy8XODLn1QUM9Ixi1y9gSgLMCNPkV2oU,1182
 meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
 meta_ads_mcp/core/__init__.py,sha256=XVJjMOfdgnqxy3k8vCn2PCf7za8fMk4BdgJGiSFCVZY,1209
 meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
-meta_ads_mcp/core/ads.py,sha256=Ss0VaSjm7J4g7zUZLPLzz-WGC8h-SdhV_mtBRUNpkgE,29808
+meta_ads_mcp/core/ads.py,sha256=t3COpPA-TGsOYndq0vWA9XR0L7sg1cGHNrM2HK24Q6I,33424
 meta_ads_mcp/core/ads_library.py,sha256=onStn9UkRqYDC60gOPS-iKDtP1plz6DygUb7hUZ0Jw8,2807
 meta_ads_mcp/core/adsets.py,sha256=k76rm3rkhEebUzvBnM_QaVktrzGTKvTJOtWbBd6s3i8,10399
 meta_ads_mcp/core/api.py,sha256=aAzM6Q75VQOFXtr5D-mDmBRhxWK4wsiODsJYnR3mpDI,14994
@@ -18,9 +18,9 @@ meta_ads_mcp/core/pipeboard_auth.py,sha256=VvbxEB8ZOhnMccLU7HI1HgaPWHCl5NGrzZCm-
 meta_ads_mcp/core/reports.py,sha256=Dv3hfsPOR7IZ9WrYrKd_6SNgZl-USIphg7knva3UYAw,5747
 meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0w,1236
 meta_ads_mcp/core/server.py,sha256=mmhtcyB7h1aO6jK4njLztPdAebPDmc3mhA7DksR1nlY,17583
-meta_ads_mcp/core/utils.py,sha256=DsizDYuJnWUpkbShV1y5Qe8t47Qf59aPZ6O9v0hzdkY,6705
-meta_ads_mcp-0.4.5.dist-info/METADATA,sha256=jS17u-iv9a7XlbmsIqZT9-FPWfUsmEpfPY7U68BCWJA,17580
-meta_ads_mcp-0.4.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.4.5.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.4.5.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.4.5.dist-info/RECORD,,
+meta_ads_mcp/core/utils.py,sha256=ofKUhyo-5SZoJVuBeTVFPPQCffk0UKpwmDMrd8qQxNc,8715
+meta_ads_mcp-0.4.7.dist-info/METADATA,sha256=uxNO8COPSkDIPtTrw-fNDoty0k8IbFCZtVS2QfyO2lA,17580
+meta_ads_mcp-0.4.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.4.7.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.4.7.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.4.7.dist-info/RECORD,,