meta-ads-mcp 0.4.6__py3-none-any.whl → 0.4.7__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
meta_ads_mcp/__init__.py CHANGED
@@ -7,7 +7,7 @@ with the Claude LLM.
7
7
 
8
8
  from meta_ads_mcp.core.server import main
9
9
 
10
- __version__ = "0.4.6"
10
+ __version__ = "0.4.7"
11
11
 
12
12
  __all__ = [
13
13
  'get_ad_accounts',
meta_ads_mcp/core/ads.py CHANGED
@@ -10,7 +10,7 @@ import time
10
10
 
11
11
  from .api import meta_api_tool, make_api_request
12
12
  from .accounts import get_ad_accounts
13
- from .utils import download_image, try_multiple_download_methods, ad_creative_images
13
+ from .utils import download_image, try_multiple_download_methods, ad_creative_images, extract_creative_image_urls
14
14
  from .server import mcp_server
15
15
 
16
16
 
@@ -179,7 +179,7 @@ async def get_ad_creatives(access_token: str = None, ad_id: str = None) -> str:
179
179
  # Add image URLs for direct viewing if available
180
180
  if 'data' in data:
181
181
  for creative in data['data']:
182
- creative['image_urls_for_viewing'] = ad_creative_images(creative)
182
+ creative['image_urls_for_viewing'] = extract_creative_image_urls(creative)
183
183
 
184
184
  return json.dumps(data, indent=2)
185
185
 
@@ -1,6 +1,6 @@
1
1
  """Utility functions for Meta Ads API."""
2
2
 
3
- from typing import Optional, Dict, Any
3
+ from typing import Optional, Dict, Any, List
4
4
  import httpx
5
5
  import io
6
6
  from PIL import Image as PILImage
@@ -74,6 +74,64 @@ logger = setup_logging()
74
74
  # Global store for ad creative images
75
75
  ad_creative_images = {}
76
76
 
77
+
78
+ def extract_creative_image_urls(creative: Dict[str, Any]) -> List[str]:
79
+ """
80
+ Extract image URLs from a creative object for direct viewing.
81
+
82
+ Args:
83
+ creative: Meta Ads creative object
84
+
85
+ Returns:
86
+ List of image URLs found in the creative
87
+ """
88
+ image_urls = []
89
+
90
+ # Check for direct image_url field
91
+ if "image_url" in creative and creative["image_url"]:
92
+ image_urls.append(creative["image_url"])
93
+
94
+ # Check for thumbnail_url field
95
+ if "thumbnail_url" in creative and creative["thumbnail_url"]:
96
+ image_urls.append(creative["thumbnail_url"])
97
+
98
+ # Check object_story_spec for image URLs
99
+ if "object_story_spec" in creative:
100
+ story_spec = creative["object_story_spec"]
101
+
102
+ # Check link_data for image fields
103
+ if "link_data" in story_spec:
104
+ link_data = story_spec["link_data"]
105
+
106
+ # Check for picture field
107
+ if "picture" in link_data and link_data["picture"]:
108
+ image_urls.append(link_data["picture"])
109
+
110
+ # Check for image_url field in link_data
111
+ if "image_url" in link_data and link_data["image_url"]:
112
+ image_urls.append(link_data["image_url"])
113
+
114
+ # Check video_data for thumbnail (if present)
115
+ if "video_data" in story_spec and "image_url" in story_spec["video_data"]:
116
+ image_urls.append(story_spec["video_data"]["image_url"])
117
+
118
+ # Check asset_feed_spec for multiple images
119
+ if "asset_feed_spec" in creative and "images" in creative["asset_feed_spec"]:
120
+ for image in creative["asset_feed_spec"]["images"]:
121
+ if "url" in image and image["url"]:
122
+ image_urls.append(image["url"])
123
+
124
+ # Remove duplicates while preserving order
125
+ seen = set()
126
+ unique_urls = []
127
+ for url in image_urls:
128
+ if url not in seen:
129
+ seen.add(url)
130
+ unique_urls.append(url)
131
+
132
+ return unique_urls
133
+
134
+
77
135
  async def download_image(url: str) -> Optional[bytes]:
78
136
  """
79
137
  Download an image from a URL.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: meta-ads-mcp
3
- Version: 0.4.6
3
+ Version: 0.4.7
4
4
  Summary: Model Context Protocol (MCP) plugin for interacting with Meta Ads API
5
5
  Project-URL: Homepage, https://github.com/pipeboard-co/meta-ads-mcp
6
6
  Project-URL: Bug Tracker, https://github.com/pipeboard-co/meta-ads-mcp/issues
@@ -1,8 +1,8 @@
1
- meta_ads_mcp/__init__.py,sha256=NQtdhkedrnohOGhlooiRjuNIVi3c9Ra9sK34XOZxEew,1182
1
+ meta_ads_mcp/__init__.py,sha256=xGsc5RhOEUMCy8XODLn1QUM9Ixi1y9gSgLMCNPkV2oU,1182
2
2
  meta_ads_mcp/__main__.py,sha256=XaQt3iXftG_7f0Zu7Wop9SeFgrD2WBn0EQOaPMc27d8,207
3
3
  meta_ads_mcp/core/__init__.py,sha256=XVJjMOfdgnqxy3k8vCn2PCf7za8fMk4BdgJGiSFCVZY,1209
4
4
  meta_ads_mcp/core/accounts.py,sha256=Nmp7lPxO9wmq25jWV7_H0LIqnEbBhpCVBlLGW2HUaq0,2277
5
- meta_ads_mcp/core/ads.py,sha256=rEekkED-n2SCWAdSm9rzk08aM_L56DEpyVgd869pLgE,33386
5
+ meta_ads_mcp/core/ads.py,sha256=t3COpPA-TGsOYndq0vWA9XR0L7sg1cGHNrM2HK24Q6I,33424
6
6
  meta_ads_mcp/core/ads_library.py,sha256=onStn9UkRqYDC60gOPS-iKDtP1plz6DygUb7hUZ0Jw8,2807
7
7
  meta_ads_mcp/core/adsets.py,sha256=k76rm3rkhEebUzvBnM_QaVktrzGTKvTJOtWbBd6s3i8,10399
8
8
  meta_ads_mcp/core/api.py,sha256=aAzM6Q75VQOFXtr5D-mDmBRhxWK4wsiODsJYnR3mpDI,14994
@@ -18,9 +18,9 @@ meta_ads_mcp/core/pipeboard_auth.py,sha256=VvbxEB8ZOhnMccLU7HI1HgaPWHCl5NGrzZCm-
18
18
  meta_ads_mcp/core/reports.py,sha256=Dv3hfsPOR7IZ9WrYrKd_6SNgZl-USIphg7knva3UYAw,5747
19
19
  meta_ads_mcp/core/resources.py,sha256=-zIIfZulpo76vcKv6jhAlQq91cR2SZ3cjYZt3ek3x0w,1236
20
20
  meta_ads_mcp/core/server.py,sha256=mmhtcyB7h1aO6jK4njLztPdAebPDmc3mhA7DksR1nlY,17583
21
- meta_ads_mcp/core/utils.py,sha256=DsizDYuJnWUpkbShV1y5Qe8t47Qf59aPZ6O9v0hzdkY,6705
22
- meta_ads_mcp-0.4.6.dist-info/METADATA,sha256=ll3IptQlRpXwTtNLah8mDG1FzRhS_OKhIPMsTeA8ikE,17580
23
- meta_ads_mcp-0.4.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
24
- meta_ads_mcp-0.4.6.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
25
- meta_ads_mcp-0.4.6.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
26
- meta_ads_mcp-0.4.6.dist-info/RECORD,,
21
+ meta_ads_mcp/core/utils.py,sha256=ofKUhyo-5SZoJVuBeTVFPPQCffk0UKpwmDMrd8qQxNc,8715
22
+ meta_ads_mcp-0.4.7.dist-info/METADATA,sha256=uxNO8COPSkDIPtTrw-fNDoty0k8IbFCZtVS2QfyO2lA,17580
23
+ meta_ads_mcp-0.4.7.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
24
+ meta_ads_mcp-0.4.7.dist-info/entry_points.txt,sha256=Dv2RkoBjRJBqj6CyhwqGIiwPCD-SCL1-7B9-zmVRuv0,57
25
+ meta_ads_mcp-0.4.7.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
26
+ meta_ads_mcp-0.4.7.dist-info/RECORD,,