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#

bash

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:

bash

export AGENTCY_API_KEY="agcy_your_key_here"

Verify#

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

bash

./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.

bash

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

ArgRequiredDescriptionquestionYesNatural language question about marketing datadomainYesClient domain to query (e.g., "example.com")start_dateNoDefault: "30daysAgo". Accepts YYYY-MM-DD or relative ("7daysAgo")end_dateNoDefault: "yesterday". Accepts YYYY-MM-DD or relative ("yesterday")source_hintsNoComma-separated data source hints (e.g., "ga4,gsc")

Examples:

bash

# 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.

bash

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

ArgRequiredDescriptionquestionYesNatural language research questiondomainNoClient domain for context (helps scope competitive research)

Examples:

bash

./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.

bash

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

Examples:

bash

# 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#

SourceCategoryAuthGoogle Analytics 4AnalyticsGoogle OAuthGoogle Search ConsoleSearch / SEOGoogle OAuthGoogle AdsAdvertisingGoogle OAuthYouTube AnalyticsVideo / ContentGoogle OAuthWooCommerceE-commerceAPI KeyHubSpotCRM / MarketingAPI KeySpyFuCompetitive IntelAPI KeyPageSpeed, DNS, SSL, WHOIS, Sitemap, Schema, Readability, Tech DetectionWeb UtilitiesIncludedWeb IntelligenceResearchIncluded

External Endpoints#

EndpointMethodPurposeAuthhttps://data.goagentcy.com/api/queryPOSTQuery marketing data sourcesBearer token (AGENTCY_API_KEY)https://data.goagentcy.com/api/researchPOSTWeb research and competitive intelligenceBearer token (AGENTCY_API_KEY)https://data.goagentcy.com/api/sourcesGETList configured domains and data sourcesBearer token (AGENTCY_API_KEY)

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