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: INLINECODE0
- Accepted alias: INLINECODE1
- Required env var:
HIENERGY_API_KEY (or HI_ENERGY_API_KEY) - Runtime host:
https://app.hienergy.ai only - Homepage: INLINECODE5
- Source: INLINECODE6
Setup
CODEBLOCK0
Tip: copy .env.example to .env for local development, then export from it in your shell.
Quick usage
CODEBLOCK1
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 → INLINECODE9
- Advertiser search by domain/url → INLINECODE10
- Advertiser detail/profile → INLINECODE11
- Affiliate program lookup → INLINECODE12
- Affiliate program ranking/research → INLINECODE13
- Deals/offers →
find_deals (supports active, exclusive, country filters) - Transactions/reporting →
get_transactions (supports date range, advertiser, network, currency filters + sorting) - Contacts → INLINECODE16
- Status changes (approvals/rejections) →
get_status_changes (supports from/to status, advertiser filters) - Publisher details → INLINECODE18
- Publisher update →
update_publisher (admin/publisher) - Contact create/replace →
create_contact, replace_contact (admin/publisher) - Agency/client management →
get_agencies (supports agencyid filter if applicable) - Tag/Category search → INLINECODE23
- Advertisers by Tag →
get_tag_advertisers (supports sort by sales/commissions) - Contact discovery (API search only) →
get_contacts (filters by name/email/advertiserid 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:
- INLINECODE35
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:
INLINECODE37
Resources
- -
scripts/hienergy_skill.py — API client and Q&A helper - INLINECODE39 — CLI for creating contacts (admin only)
- INLINECODE40 — endpoint map and usage hints
Hi Energy AI
使用此技能从HiEnergy数据中查找和管理联盟营销计划及联盟交易,以及相关的广告商、交易和合作伙伴联系人。
访问模式(重要)
- - HiEnergy 按用户发放API密钥。
- 您的API密钥可访问与HiEnergy网页应用中相同的数据。
- Pro用户可查看额外字段/数据,尤其是关于广告商状态和联系人的信息。
安全与凭证
- - 主要凭证:HIENERGYAPIKEY
- 可接受别名:HIENERGYAPIKEY
- 必需环境变量:HIENERGYAPIKEY(或HIENERGYAPIKEY)
- 运行时主机:仅限https://app.hienergy.ai
- 官网:https://www.hienergy.ai
- 来源:https://github.com/HiEnergyAgency/openclawskill
设置
bash
export HIENERGYAPIKEY=apikey>
可选别名
export HIENERGYAPIKEY=$HIENERGYAPI_KEY
pip install -r requirements.txt
提示:将.env.example复制为.env用于本地开发,然后在shell中从中导出。
快速使用
python
from scripts.hienergy_skill import HiEnergySkill
skill = HiEnergySkill()
advertisers = skill.get_advertisers(search=fitness, limit=10)
programs = skill.getaffiliateprograms(search=supplements, limit=10)
contacts = skill.get_contacts(search=john, limit=10)
answer = skill.answer_question(Research top affiliate programs for supplements)
高效提示(复制/粘贴)
- - 查找[垂直领域]中佣金>=10%的顶级联盟计划。
- 显示[品牌/品类]的活跃联盟交易,并按支付潜力排序。
- 查找[广告商]的合作伙伴联系人,并总结下一步外联筛选条件。
意图路由
- - 按名称搜索广告商 → getadvertisers
- 按域名/网址搜索广告商 → getadvertisersbydomain
- 广告商详情/资料 → getadvertiserdetails
- 联盟计划查询 → getaffiliateprograms
- 联盟计划排名/研究 → researchaffiliateprograms
- 交易/优惠 → finddeals(支持活跃、独家、国家筛选)
- 交易/报告 → gettransactions(支持日期范围、广告商、网络、货币筛选及排序)
- 联系人 → getcontacts
- 状态变更(批准/拒绝) → getstatuschanges(支持起始/结束状态、广告商筛选)
- 发布者详情 → getpublisher
- 更新发布者 → updatepublisher(管理员/发布者)
- 创建/替换联系人 → createcontact、replacecontact(管理员/发布者)
- 代理/客户管理 → getagencies(如适用,支持agencyid筛选)
- 标签/类别搜索 → searchtags
- 按标签搜索广告商 → gettagadvertisers(支持按销售额/佣金排序)
- 联系人发现(仅API搜索) → getcontacts(按HiEnergy中已存在的名称/邮箱/advertiserid筛选)
响应规则
- - 每次查询以通俗语言立即确认,例如在返回结果前说正在联盟计划中查找cbd计划...。
- 在回复中包含简短的提示:行,告知用户可搜索的内容(广告商、计划、交易/优惠、交易、联系人及有用筛选条件)。
- 对于计划研究,标准化佣金格式(百分比、百分比范围、固定CPA),并在结果中清晰标注佣金类型。
- 保持摘要简洁且基于数据。
- 在广泛扫描前使用精确筛选(search、category、advertiserid、limit)。
- 对于广告商列表回复,提供更详细信息;如果用户确认,调用getadvertiser_details。
- 若无匹配结果,建议相近搜索词。
- 为保持一致性,优先采用以下回复结构:
- 摘要:
- 主要结果:
- 下一步筛选:
可靠性规则
- - 将API失败视为可恢复,并清晰解释。
- 处理429速率限制时,给出友好的重试提示。
- 聊天中使用安全模式默认值(limit=20),仅在用户要求时增加。
- 绝不虚构计划、交易、联系人及指标。
ClawHub可发现性标签
发布时使用这些标签以提高搜索排名:
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
资源
- - scripts/hienergyskill.py — API客户端及问答助手
- scripts/createcontact.py — 创建联系人的命令行工具(仅管理员)
- references/endpoints.md — 端点映射及使用提示