Meta Ads Agent

D 54 completed
Cli Tool
unknown / python · tiny
9
Files
790
LOC
0
Frameworks
4
Languages

Pipeline State

completed
Run ID
#371276
Phase
done
Progress
1%
Started
Finished
2026-04-13 01:31:02
LLM tokens
0

Pipeline Metadata

Stage
Skipped
Decision
skip_tiny
Novelty
23.97
Framework unique
Isolation
Last stage change
2026-04-16 18:15:42
Deduplication group #47591
Member of a group with 1 similar repo(s) — canonical #65621 view group →
Top concepts (2)
Project DescriptionBot
Citation: Repobility (2026). State of AI-Generated Code. https://repobility.com/research/

AI Prompt

Create a Python client that allows users to ask natural language questions about their Facebook or Instagram ad performance. The tool needs to interact with the Meta Marketing API to fetch and analyze data regarding metrics like spend, ROAS, CTR, and conversions. I need functionality to compare performance across different time periods, such as comparing yesterday to last week, and to generate daily reports. The core logic should be manageable through a main client file, and I should also have a mechanism to manage and refresh the access tokens using environment variables.
python meta-api facebook instagram ad-performance natural-language api-client data-analysis
Generated by gemma4:latest

Catalog Information

A Python client that lets users ask natural language questions about Facebook/Instagram ad performance, which Claude Code automatically fetches and analyzes data for.

Description

Meta Ads Agent is a Python-based client that integrates with Claude Code to answer natural language queries about Facebook and Instagram advertising performance. It retrieves campaign, ad set, and ad data from the Meta Marketing API, processes it with pandas, and presents insights such as spend, ROAS, CTR, and conversions. Users can ask questions like "What was my ROAS last month?" or "Which campaigns have the highest CTR?" and receive instant, data-driven responses. The tool is designed for marketers and analysts who need quick, actionable insights without writing code. It handles token management, long‑lived access, and provides a simple CLI interface for easy deployment.

الوصف

يُعد Meta Ads Agent عميلًا مبنيًا بلغة بايثون يدمج مع Claude Code للإجابة على أسئلة المستخدمين باللغة الطبيعية حول أداء إعلانات فيسبوك وإنستغرام. يقوم بجلب بيانات الحملات، مجموعات الإعلانات، والإعلانات من واجهة Meta Marketing API، ثم يعالجها باستخدام مكتبة pandas ليقدم تحليلات مثل الإنفاق، العائد على الإنفاق (ROAS)، معدل النقر (CTR)، والتحويلات. يمكن للمستخدمين طرح أسئلة مثل "ما هو ROAS الخاص بي الشهر الماضي؟" أو "أي الحملات لديها أعلى CTR؟" والحصول على إجابات فورية مبنية على البيانات. يهدف الأداة إلى مساعدة المسوقين والمحللين في الحصول على رؤى عملية بسرعة ودون الحاجة لكتابة كود. تدير الأداة أيضًا عملية إدارة الرموز المميزة، بما في ذلك التمديد إلى رموز طويلة الأمد، وتوفر واجهة سطر أوامر بسيطة لتسهيل النشر.

Novelty

6/10

Tags

ad-performance-analysis natural-language-queries marketing-insights campaign-comparison roi-tracking data-fetching facebook-advertising instagram-advertising

Technologies

pandas

Claude Models

claude-opus-4.6 claude (unknown version)

Quality Score

D
53.8/100
Structure
44
Code Quality
70
Documentation
61
Testing
0
Practices
63
Security
90
Dependencies
60

Strengths

  • Consistent naming conventions (snake_case)
  • Good security practices \u2014 no major issues detected

Weaknesses

  • No LICENSE file \u2014 legal ambiguity for contributors
  • No tests found \u2014 high risk of regressions
  • No CI/CD configuration \u2014 manual testing and deployment
  • 1 bare except/catch blocks swallowing errors
  • Potential hardcoded secrets in 1 files

Recommendations

  • Add a test suite \u2014 start with critical path integration tests
  • Set up CI/CD (GitHub Actions recommended) to automate testing and deployment
  • Add a linter configuration to enforce code style consistency
  • Add a LICENSE file (MIT recommended for open source)
  • Replace bare except/catch blocks with specific exception types
  • Move hardcoded secrets to environment variables or a secrets manager

Security & Health

4.6h
Tech Debt (E)
A
OWASP (100%)
PASS
Quality Gate
A
Risk (10)
Repobility · severity-and-effort ranking · https://repobility.com
Unknown
License
0.0%
Duplication
Full Security Report AI Fix Prompts SARIF SBOM

Languages

python
63.8%
markdown
30.6%
shell
5.1%
text
0.5%

Frameworks

None detected

Concepts (2)

Repobility · code-quality scanner for AI-generated software · https://repobility.com
CategoryNameDescriptionConfidence
Repobility · code-quality intelligence · https://repobility.com
auto_descriptionProject DescriptionMeta Marketing API client for analyzing Facebook/Instagram ad performance with Claude Code.80%
auto_categoryBotbot70%

Quality Timeline

1 quality score recorded.

View File Metrics

Embed Badge

Add to your README:

![Quality](https://repos.aljefra.com/badge/95485.svg)
Quality BadgeSecurity Badge
Export Quality CSVDownload SBOMExport Findings CSV