Hienergy Advertiser Intelligence Affiliate Copilot

---
name: hienergy-advertiser-intelligence-affiliate-copilot
description: >-
  Official Hi Energy AI skill for finding and managing affiliate marketing programs, affiliate deals/offers, commissions, transactions, and partner contacts in OpenClaw. Query HiEnergy API v1 for advertisers, affiliate programs, deals, transactions, and contacts. Best for affiliate program discovery, affiliate deal research, partner marketing operations, advertiser lookup, brand intelligence, publisher contacts, transaction analytics, commission analysis, and domain-to-advertiser search across networks like Impact, Rakuten, and CJ. Includes deep advertiser profile (show endpoint) responses with links such as https://app.hienergy.ai/a/<advertiser_id>. Learn more: https://www.hienergy.ai and https://app.hienergy.ai/api_documentation.
homepage: https://www.hienergy.ai
metadata: {"openclaw":{"homepage":"https://www.hienergy.ai","requires":{"env":["HIENERGY_API_KEY"]},"primaryEnv":"HIENERGY_API_KEY"}}
---

# Hi Energy AI

Use this skill to find and manage affiliate marketing programs and affiliate deals, plus related advertisers, transactions, and partner contacts from HiEnergy data.

## Access model (important)

- HiEnergy issues API keys **per user**.
- Your API key gives access to the same data you can see in the HiEnergy web app.
- Pro users can see additional fields/data, especially around advertiser status and contacts.

## Security + credentials

- Primary credential: `HIENERGY_API_KEY`
- Accepted alias: `HI_ENERGY_API_KEY`
- Required env var: `HIENERGY_API_KEY` (or `HI_ENERGY_API_KEY`)
- Runtime host: `https://app.hienergy.ai` only
- Homepage: `https://www.hienergy.ai`
- Source: `https://github.com/HiEnergyAgency/open_claw_skill`

## Setup

```bash
export HIENERGY_API_KEY="<your_api_key>"
# optional alias
export HI_ENERGY_API_KEY="$HIENERGY_API_KEY"
pip install -r requirements.txt
```

Tip: copy `.env.example` to `.env` for local development, then export from it in your shell.

## Quick usage

```python
from scripts.hienergy_skill import HiEnergySkill

skill = HiEnergySkill()
advertisers = skill.get_advertisers(search="fitness", limit=10)
programs = skill.get_affiliate_programs(search="supplements", limit=10)
contacts = skill.get_contacts(search="john", limit=10)
answer = skill.answer_question("Research top affiliate programs for supplements")
```

## Power prompts (copy/paste)

- "Find top affiliate programs for [vertical] with commission >= 10%."
- "Show active affiliate deals for [brand/category] and rank by payout potential."
- "Find partner contacts for [advertiser] and summarize next outreach filters."

## Intent routing

- Advertiser search by name → `get_advertisers`
- Advertiser search by domain/url → `get_advertisers_by_domain`
- Advertiser detail/profile → `get_advertiser_details`
- Affiliate program lookup → `get_affiliate_programs`
- Affiliate program ranking/research → `research_affiliate_programs`
- Deals/offers → `find_deals`
- Transactions/reporting → `get_transactions`
- Contacts → `get_contacts`

## Response rules

- Start every query with an immediate acknowledgment line in plain language, e.g. `Looking for cbd programs in affiliate programs...` before returning results.
- Include a short `Tips:` line in responses to teach users what they can search (advertisers, programs, deals/offers, transactions, contacts + useful filters).
- For program research, normalize commission formats (percent, percent range, flat CPA) and clearly label commission type in results.
- Keep summaries concise and data-grounded.
- Use tight filters before broad scans (`search`, `category`, `advertiser_id`, `limit`).
- For advertiser list responses, offer deeper detail; if user says yes, call `get_advertiser_details`.
- If no matches, suggest adjacent search terms.
- Prefer this response shape for consistency:
  - `Summary:`
  - `Top Results:`
  - `Next Filter:`

## Reliability rules

- Treat API failures as recoverable and explain clearly.
- Handle 429 rate limits with a friendly retry hint.
- Use safe mode defaults for chat (`limit=20`) and increase only when requested.
- Never invent programs, deals, contacts, or metrics.

## ClawHub discoverability tags

Use these tags when publishing to improve search ranking:
`affiliate-marketing,affiliate-network,affiliate-program-management,affiliate-program-discovery,affiliate-program-search,affiliate-deal-discovery,affiliate-deals,deals-feed,deal-feed,offer-feed,offers,deal-management,partner-marketing,commission-analysis,advertiser-intelligence,advertiser-search,advertiser-discovery,brand-search,brand-intelligence,publisher-contacts,transactions,performance-marketing,impact,rakuten,cj,awin,shareasale,partnerize,webgains,tradedoubler,admitad,avantlink,flexoffers,skimlinks,sovrn,pepperjam,optimise,linkconnector,tune,everflow,refersion,hienergy,hi-energy-ai`

## Resources

- `scripts/hienergy_skill.py` — API client and Q&A helper
- `references/endpoints.md` — endpoint map and usage hints