meta-ads-mcp 0.4.6__py3-none-any.whl → 0.4.8__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.6"
+__version__ = "0.4.8"
 
 __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)
 
@@ -251,14 +251,27 @@ async def get_ad_image(access_token: str = None, ad_id: str = None) -> Image:
     if not image_hashes:
         # If no hashes found, try to extract from the first creative we found in the API
         # Get creative for ad to try to extract hash
-        creative_json = await get_ad_creatives(ad_id, "", access_token)
-        creative_data = json.loads(creative_json)
-        
-        # Try to extract hash from asset_feed_spec
-        if "asset_feed_spec" in creative_data and "images" in creative_data["asset_feed_spec"]:
-            images = creative_data["asset_feed_spec"]["images"]
-            if images and len(images) > 0 and "hash" in images[0]:
-                image_hashes.append(images[0]["hash"])
+        creative_json = await get_ad_creatives(access_token=access_token, ad_id=ad_id)
+        # The result is wrapped by @meta_api_tool, so we need to extract the data
+        creative_wrapper = json.loads(creative_json)
+        creative_data = json.loads(creative_wrapper["data"])
+        
+        # Try to extract hash from data array
+        if "data" in creative_data and creative_data["data"]:
+            for creative in creative_data["data"]:
+                # Check object_story_spec for image hash
+                if "object_story_spec" in creative and "link_data" in creative["object_story_spec"]:
+                    link_data = creative["object_story_spec"]["link_data"]
+                    if "image_hash" in link_data:
+                        image_hashes.append(link_data["image_hash"])
+                # Check direct image_hash on creative
+                elif "image_hash" in creative:
+                    image_hashes.append(creative["image_hash"])
+                # Check asset_feed_spec for image hashes
+                elif "asset_feed_spec" in creative and "images" in creative["asset_feed_spec"]:
+                    images = creative["asset_feed_spec"]["images"]
+                    if images and len(images) > 0 and "hash" in images[0]:
+                        image_hashes.append(images[0]["hash"])
     
     if not image_hashes:
         return "Error: No image hashes found in creative"
@@ -380,7 +393,9 @@ async def save_ad_image_locally(access_token: str = None, ad_id: str = None, out
     if not image_hashes:
         # Fallback attempt (as in get_ad_image)
         creative_json = await get_ad_creatives(ad_id=ad_id, access_token=access_token) # Ensure ad_id is passed correctly
-        creative_data_list = json.loads(creative_json)
+        # The result is wrapped by @meta_api_tool, so we need to extract the data
+        creative_wrapper = json.loads(creative_json)
+        creative_data_list = json.loads(creative_wrapper["data"])
         if 'data' in creative_data_list and creative_data_list['data']:
              first_creative = creative_data_list['data'][0]
              if 'object_story_spec' in first_creative and 'link_data' in first_creative['object_story_spec'] and 'image_hash' in first_creative['object_story_spec']['link_data']:

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.6.dist-info → meta_ads_mcp-0.4.8.dist-info}/METADATA

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

@@ -1,8 +1,8 @@
-meta_ads_mcp/__init__.py,sha256=NQtdhkedrnohOGhlooiRjuNIVi3c9Ra9sK34XOZxEew,1182
+meta_ads_mcp/__init__.py,sha256=gDY8drq5dj3hFy9EmqLzzto7l_nD8pXFULiiEwZL8YU,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=rEekkED-n2SCWAdSm9rzk08aM_L56DEpyVgd869pLgE,33386
+meta_ads_mcp/core/ads.py,sha256=wKQBrDSlZLUZDUEIcuphf3ltBbuYM5vg5mZ31UiZ9mE,34432
 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.6.dist-info/METADATA,sha256=ll3IptQlRpXwTtNLah8mDG1FzRhS_OKhIPMsTeA8ikE,17580
-meta_ads_mcp-0.4.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-meta_ads_mcp-0.4.6.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
-meta_ads_mcp-0.4.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-meta_ads_mcp-0.4.6.dist-info/RECORD,,
+meta_ads_mcp/core/utils.py,sha256=ofKUhyo-5SZoJVuBeTVFPPQCffk0UKpwmDMrd8qQxNc,8715
+meta_ads_mcp-0.4.8.dist-info/METADATA,sha256=TYL2W6RFXPEI3yLw71SmqmuJq2M5i2fxvzrHm-N2URU,17580
+meta_ads_mcp-0.4.8.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+meta_ads_mcp-0.4.8.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
+meta_ads_mcp-0.4.8.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+meta_ads_mcp-0.4.8.dist-info/RECORD,,