amazon-ads-cli

v0.1.15 safe
4.0
Medium Risk

CLI tool for Amazon Advertising API v3

🤖 AI Analysis

Final verdict: SAFE

The package shows low to moderate risks with no clear signs of malicious intent. The execution of shell commands is a concern but not conclusive evidence of harmful behavior.

  • Moderate network and shell execution risks
  • Low metadata risk with no signs of malice
Per-check LLM notes
  • Network: GET requests and decompression of responses suggest normal data retrieval activities.
  • Shell: Execution of shell commands without capturing output may indicate risky behavior, possibly for system interaction but could be a security concern.
  • Metadata: Low activity and new maintainer suggest potential risk, but no clear signs of malice.

📦 Package Quality Overall: Low (3.6/10)

✦ High Test Suite 9.0

Test suite present — 12 test file(s) found

  • Test runner config found: pyproject.toml
  • 12 test file(s) detected (e.g. __init__.py)
○ Low Documentation 1.0

No documentation detected

  • No documentation URL, doc files, or meaningful description found
○ Low Contributing Guide 2.0

No contributing guide or governance files found

  • No CONTRIBUTING, CODE_OF_CONDUCT, or governance files found
○ Low Type Annotations 1.0

No type annotations detected

  • No type annotations, py.typed marker, or stub files detected
◈ Medium Multiple Contributors 5.0

Limited contributor diversity

  • 1 unique contributor(s) across 36 commits in stellaraether/amazon-ads-cli
  • Single author but highly active (36 commits)

🔬 Heuristic Checks

⚠ Outbound Network Calls score 3.0

Found 2 network call pattern(s)

  • ") response = requests.get(url) data = gzip.decompress(response.content
  • eport...") response = requests.get(url) data = gzip.decompress(response.content)
✓ Code Obfuscation

No obfuscation patterns detected

⚠ Shell / Subprocess Execution score 2.0

Found 1 shell execution pattern(s)

  • ads-cli...") result = subprocess.run(cmd, capture_output=False) if result.returncode !=
✓ Credential Harvesting

No credential harvesting patterns detected

✓ Typosquatting

No typosquatting candidates detected

✓ Registered Email Domain

Email domain looks legitimate: stellaraether.com

✓ Suspicious Page Links

All external links appear legitimate

⚠ Git Repository History score 2.5

Git history flags: Repository has zero stars and zero forks

  • Repository has zero stars and zero forks
⚠ Maintainer History score 2.0

1 maintainer concern(s) found

  • Author "Lunan Li" appears to have only 1 package on PyPI (new or inactive account)
✓ Known CVE Vulnerabilities

No known vulnerabilities found in OSV database.

💡 AI App Starter Prompt

Use this prompt to build a project with amazon-ads-cli 
Develop a Python-based command-line utility named 'AdInsight' that leverages the 'amazon-ads-cli' package to provide comprehensive insights into Amazon Advertising campaigns. This utility should be designed for advertisers and marketers who want to streamline their analysis of ad performance without having to manually interact with the Amazon Advertising API. Here’s a step-by-step guide on how to build this application:

1. **Setup Environment**: Ensure your development environment has Python installed, along with the necessary libraries such as 'boto3' and 'amazon-ads-cli'. Use pip to install 'amazon-ads-cli' if it isn't already available.

2. **Authentication**: Implement a secure way to authenticate users with Amazon Advertising API using OAuth 2.0. Provide instructions for obtaining the necessary credentials from Amazon Advertising API documentation.

3. **Core Features**:
   - **Campaign Overview**: Fetch and display an overview of all active campaigns, including total spend, clicks, impressions, and conversion rates.
   - **Detailed Reports**: Allow users to generate detailed reports for specific campaigns over a given date range, showing metrics like CPC (Cost Per Click), CTR (Click Through Rate), and CPA (Cost Per Acquisition).
   - **Budget Management**: Enable users to view current budgets and adjust them according to business needs.
   - **Keyword Performance**: Analyze keyword performance within campaigns, showing which keywords are driving the most traffic and conversions.
   - **Competitor Analysis**: Integrate a feature that compares user campaigns against competitors based on similar products or categories.

4. **User Interface**: Design a clean and intuitive CLI interface that guides users through various actions, from authentication to generating reports. Include help options and error handling to enhance user experience.

5. **Testing**: Write unit tests for critical functionalities to ensure reliability. Test different scenarios, including edge cases, to make sure the application handles unexpected inputs gracefully.

6. **Documentation**: Create a comprehensive README file detailing installation steps, usage examples, and how to contribute to the project.

7. **Deployment**: Package the application using tools like PyInstaller or Docker to create standalone executables or containerized applications that can be easily distributed.

The 'amazon-ads-cli' package will be utilized primarily for interfacing with the Amazon Advertising API. It simplifies the process of making requests and handling responses, allowing you to focus more on implementing the business logic of 'AdInsight'.

💬 Discussion Feed

Leave a comment

No discussion yet. Be the first to share your thoughts!