Agentcy — Your Claw's Marketing Analyst

Your OpenClaw team's marketing analyst — just tell your agent what you need to know about your clients' marketing and Agentcy delivers synthesized insights a...

Security Scan

The skill's required files, environment variable, and runtime instructions match its stated purpose (calling Agentcy's APIs with an API key); nothing requests unrelated access or performs unexpected actions.

Purpose & Capability

Name/description (marketing analyst covering GA4, Ads, Search Console, WooCommerce, etc.) aligns with the actual behavior: three shell scripts that call Agentcy REST endpoints to query research, data, and configured sources.

Instruction Scope

SKILL.md and the scripts only instruct the agent to call https://data.goagentcy.com API endpoints, build JSON payloads with jq, and print returned synthesized text. They do not read arbitrary files, other env vars, or send data to unexpected endpoints.

Install Mechanism

No install spec; included files are simple shell scripts. No downloads or archive extraction are performed by the skill itself, which minimizes install-time risk.

Credentials

The skill requires a single API key (AGENTCY_API_KEY) which is used as a bearer token to contact the documented endpoints — proportional and expected for this integration. No unrelated credentials or config paths are requested.

Persistence & Privilege

always is false and the skill does not request persistent elevated privileges or modify other skills. It behaves as a normal user-invokable skill.

Assessment

This skill appears coherent and only needs the single AGENTCY_API_KEY to operate. Before installing: confirm you trust goagentcy.com, understand that the key grants the skill access to any data you have connected in the Agentcy portal (Google OAuth connections, WooCommerce, HubSpot, etc.), and ensure you do not reuse a high-privilege or multi-service secret. If you need stronger assurance, review Agentcy's privacy/policy or test with a limited-scope API key or test account first.

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]

Arg	Required	Description
question	Yes	Natural language question about marketing data
domain	Yes	Client domain to query (e.g., "example.com")
start_date	No	Default: "30daysAgo". Accepts YYYY-MM-DD or relative ("7daysAgo")
end_date	No	Default: "yesterday". Accepts YYYY-MM-DD or relative ("yesterday")
source_hints	No	Comma-separated data source hints (e.g., "ga4,gsc")

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"]

Arg	Required	Description
question	Yes	Natural language research question
domain	No	Client domain for context (helps scope competitive research)

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

Source	Category	Auth
Google Analytics 4	Analytics	Google OAuth
Google Search Console	Search / SEO	Google OAuth
Google Ads	Advertising	Google OAuth
YouTube Analytics	Video / Content	Google OAuth
WooCommerce	E-commerce	API Key
HubSpot	CRM / Marketing	API Key
SpyFu	Competitive Intel	API Key
PageSpeed, DNS, SSL, WHOIS, Sitemap, Schema, Readability, Tech Detection	Web Utilities	Included
Web Intelligence	Research	Included

External Endpoints

Endpoint	Method	Purpose	Auth
https://data.goagentcy.com/api/query	POST	Query marketing data sources	Bearer token (AGENTCY_API_KEY)
https://data.goagentcy.com/api/research	POST	Web research and competitive intelligence	Bearer token (AGENTCY_API_KEY)
https://data.goagentcy.com/api/sources	GET	List configured domains and data sources	Bearer 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