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

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

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 (supports active, exclusive, country filters)
• Transactions/reporting → get_transactions (supports date range, advertiser, network, currency filters + sorting)
• Contacts → get_contacts
• Status changes (approvals/rejections) → get_status_changes (supports from/to status, advertiser filters)
• Publisher details → get_publisher
• Publisher update → update_publisher (admin/publisher)
• Contact create/replace → create_contact, replace_contact (admin/publisher)
• Agency/client management → get_agencies (supports agency_id filter if applicable)
• Tag/Category search → search_tags
• Advertisers by Tag → get_tag_advertisers (supports sort by sales/commissions)
• Contact discovery (API search only) → get_contacts (filters by name/email/advertiser_id that already exist in HiEnergy)

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
• scripts/create_contact.py — CLI for creating contacts (admin only)
• references/endpoints.md — endpoint map and usage hints