Cogny CLI · Paid Social

    Reddit Ads from your shell.

    Pull Reddit Ads reporting at campaign, ad group, or ad level, inspect targeting options and custom audiences, and push budget or status changes — all from Bash over the Reddit Ads MCP. No Ads API client to build.

    # 1. sign up (free for 15 calls) — uses your git email
    $ npx @cogny/cli init --agent claude-code
    
    # 2. see every Reddit Ads tool
    $ cogny tools list
    
    # 3. call any tool from Bash — no MCP wiring
    $ cogny tools call mcp__Reddit_Ads__tool_get_reporting --input '{…}'
    ❯ start Cogny Solo — $9/mo@cogny/cli on npm →

    cogny --who

    TWO PATHS
    You're a human

    Reddit Ads Manager makes you build a report, pick a breakdown, and export CSV per view. The CLI returns IMPRESSIONS, CLICKS, CTR, CPC, SPEND, and conversion metrics at the level you ask for as JSON in one call. Connect Reddit Ads once in Cogny Solo and let your coding agent — or scheduled reports — do the querying for you.

    ❯ start Solo
    You're an agent

    Self-onboard with one command. The CLI issues a key, wires nothing, and exposes every Reddit Ads tool over JSON-RPC. First 15 calls are free.

    $ npx @cogny/cli init --agent claude-code

    cogny tools call

    3 EXAMPLES

    Real tool names from the Reddit Ads MCP. Send --input JSON, get JSON back.

    mcp__Reddit_Ads__tool_get_reportingPerformance metrics at campaign, ad group, ad, or account level.
    $ cogny tools call mcp__Reddit_Ads__tool_get_reporting \
      --input '{"ad_account_id":"t2_a1b2c3","start_date":"2026-05-01","end_date":"2026-05-31","level":"campaign","time_granularity":"TOTAL"}'
    example response
    [
      {
        "campaign_id": "t3_camp01",
        "impressions": 412044,
        "clicks": 5123,
        "ctr": 1.24,
        "cpc": 0.62,
        "spend": 3176.26
      },
      {
        "campaign_id": "t3_camp02",
        "impressions": 104113,
        "clicks": 1880,
        "ctr": 1.81,
        "cpc": 0.48,
        "spend": 902.4
      }
    ]
    mcp__Reddit_Ads__tool_get_campaignsList campaigns with status, objective, and budget.
    $ cogny tools call mcp__Reddit_Ads__tool_get_campaigns \
      --input '{"ad_account_id":"t2_a1b2c3","status_filter":["ACTIVE"],"limit":2}'
    example response
    [
      {
        "id": "t3_camp01",
        "name": "r/programming — Conversions",
        "status": "ACTIVE",
        "objective": "CONVERSIONS"
      },
      {
        "id": "t3_camp02",
        "name": "Subreddit Mix — Traffic",
        "status": "ACTIVE",
        "objective": "TRAFFIC"
      }
    ]
    mcp__Reddit_Ads__tool_update_campaign_statusActivate or pause a campaign.
    $ cogny tools call mcp__Reddit_Ads__tool_update_campaign_status \
      --input '{"ad_account_id":"t2_a1b2c3","campaign_id":"t3_camp01","status":"PAUSED"}'
    example response
    {
      "id": "t3_camp01",
      "status": "PAUSED",
      "success": true
    }

    cogny tools list

    MORE

    A sample of the rest of the Reddit Ads surface. Run cogny tools list --json for every tool and its input schema.

    mcp__Reddit_Ads__tool_list_ad_accountsmcp__Reddit_Ads__tool_get_ad_groupsmcp__Reddit_Ads__tool_get_adsmcp__Reddit_Ads__tool_get_targeting_optionsmcp__Reddit_Ads__tool_get_custom_audiencesmcp__Reddit_Ads__tool_get_conversion_eventsmcp__Reddit_Ads__tool_update_campaign_budgetmcp__Reddit_Ads__tool_update_ad_group_targetingmcp__Reddit_Ads__tool_create_campaign

    cogny --faq

    Is this an official Reddit Ads CLI?

    No — it is the Cogny CLI calling the Reddit Ads MCP over the cogny-mcp-proxy. You authenticate once via Cogny (OAuth handled for you) and then call every tool from Bash. No Ads API app or access token to manage.

    Can I report at the ad group or ad level?

    Yes. tool_get_reporting takes a level of campaign, ad_group, ad, or account, plus DAY/HOUR/TOTAL granularity and optional client-side ID filters.

    Can my coding agent use this without MCP setup?

    Yes — that is the point. `npx @cogny/cli init --agent claude-code` issues a key, then `cogny tools call mcp__Reddit_Ads__tool_get_reporting --input ...` works from any shell. No /mcp wiring or restart needed.

    related CLIs

    /cli/tiktok-ads/cli/x-ads/cli/meta-ads/cli/linkedin-ads

    Building an agent? The full tool map for all servers is one fetch: /cli/llms.txt