pirika:~/ads-agent-tools$ cat README.md

ads-agent-tools

Internal Google Ads Keyword Research CLI

Pirika LLC develops and uses ads-agent-tools as an internal command-line tool for planning its own Google Ads campaigns.

The tool uses the Google Ads API KeywordPlanIdeaService to:

  • Generate Japanese keyword ideas
  • Retrieve historical search metrics
  • Support keyword research for Search campaigns

The tool is used only by authorized internal users of Pirika LLC. It is not available to clients or the general public.

The tool does not create or modify Google Ads accounts, campaigns, advertisements, keywords, bids, budgets, or billing settings. Google Ads data is not sold, shared, or provided to third parties.

API methods used:

  • KeywordPlanIdeaService.GenerateKeywordIdeas
  • KeywordPlanIdeaService.GenerateKeywordHistoricalMetrics

Source code:

https://github.com/mumuMun/ads-agent-tools

CLI example:

ads-agent ideas \
  --keyword "example" \
  --customer-id 123-456-7890 \
  --limit 10