Agentcy — Marketing Intelligence

All-in-one marketing intelligence for OpenClaw agents. Query analytics, ad campaigns, search rankings, e-commerce data, run competitive research, and discover connected data sources — all through the Agentcy REST API.

Quick Start

Install

npx clawhub@latest install agentcy

Configure

Step 1 — Sign up and get your API key:

1. Create an account at goagentcy.com
2. Go to the portal at app.goagentcy.com
3. Create an API key (starts with agcy_)

Step 2 — Connect your data sources:

1. In the portal, add your client domains (e.g., "aurora-fitness.com")
2. For each domain, connect the data sources you want to query:
   • Google Analytics 4 — click Connect, authorize with Google
   • Google Search Console — click Connect, authorize with Google
   • Google Ads — click Connect, authorize with Google
   • WooCommerce — enter store URL + API credentials
   • HubSpot, SpyFu, etc. — enter API keys
3. Web utilities (PageSpeed, DNS, SSL, etc.) work automatically — no setup needed

Step 3 — Set your API key:

export AGENTCY_API_KEY="agcy_your_key_here"

Verify

Run the sources command to confirm your domains and connected services:

./skills/agentcy/agentcy_sources.sh

You should see your configured domains and their connected services listed.

Commands

This skill includes three commands:

1. agentcy_query.sh — Query Marketing Data

Use when you need to answer questions about marketing performance, analytics, ad campaigns, search rankings, traffic, conversions, revenue, or any other marketing data for a client domain.

./skills/agentcy/agentcy_query.sh "question" "domain" [start_date] [end_date] [source_hints]

Examples:

# Basic query — Agentcy picks the right data source automatically
./skills/agentcy/agentcy_query.sh "How is organic traffic trending?" "aurora-fitness.com"

# With date range
./skills/agentcy/agentcy_query.sh "Google Ads performance" "aurora-fitness.com" "7daysAgo" "yesterday"

# With source hints
./skills/agentcy/agentcy_query.sh "Top converting pages" "aurora-fitness.com" "30daysAgo" "yesterday" "ga4,gsc"

2. agentcy_research.sh — Web Research & Competitive Intel

Use for competitive analysis, market research, industry trends, pricing comparisons, or any question that requires searching the web rather than querying connected data sources.

./skills/agentcy/agentcy_research.sh "research question" ["domain-for-context"]

Examples:

./skills/agentcy/agentcy_research.sh "What pricing strategies are competitors using for protein supplements?" "aurora-fitness.com"
./skills/agentcy/agentcy_research.sh "Latest Google Ads best practices for e-commerce 2026"

3. agentcy_sources.sh — Discover Data Sources

Use to check what domains are configured and which data sources are connected before running a query.

./skills/agentcy/agentcy_sources.sh ["domain"]

Examples:

# List all configured domains
./skills/agentcy/agentcy_sources.sh

# Check a specific domain
./skills/agentcy/agentcy_sources.sh "aurora-fitness.com"

Response Format

All commands return synthesized marketing insights as plain text — not raw JSON. Responses are ready to use directly in your analysis and recommendations.

• agentcy_query.sh — Returns an insight with a [Sources: ...] footer showing which data sources were used
• agentcy_research.sh — Returns synthesized research findings with sources cited
• agentcy_sources.sh — Lists domains with their connected services and always-available utilities

Data Sources Available

External Endpoints

Security & Privacy

• API key is read from the AGENTCY_API_KEY environment variable — never hardcoded
• The key is sent only to data.goagentcy.com over HTTPS
• Data isolation is enforced by the domain parameter — each query is scoped to a single client
• No marketing data is cached or stored by this skill
• Response content is synthesized text — no raw customer PII is returned
• All scripts use set -euo pipefail and build JSON payloads with jq (no shell injection)

Publisher

Agentcy — goagentcy.com