Hunyuan user agent
Operated by Tencent
Hunyuan is a Tencent crawler reported as reading public web pages to train Tencent's Hunyuan models.
The Hunyuan bot at a glance
- Hunyuan is operated by Tencent and collects public web pages that may be used to train AI models.
- The robots.txt token for Hunyuan is Hunyuan.
- Blocking an AI training crawler has no effect on Google or Bing rankings.
- Hunyuan robots.txt support: Not documented.
- Recommendation for Generative Engine Optimization (GEO): Your choice.
What is Hunyuan?
The Hunyuan crawler feeds Tencent’s model training pipeline.
Tencent has not published a crawler page for this name.
Should you block Hunyuan?
Blocking Hunyuan is a business decision: it protects your content but can lower how well AI products know your brand.
| Effect on search rankings | Blocking an AI training crawler has no effect on Google or Bing rankings. |
|---|---|
| Effect on AI visibility | Blocking keeps your future pages out of that company's training data, so its models may know less about your brand over time. It does not remove you from that company's AI search, which uses a separate bot. |
| Follows robots.txt | Not documented |
| Recommendation | Your choice |
How to block or allow Hunyuan
Put the robots.txt rule in the file at the root of every domain and subdomain, for example https://example.com/robots.txt. The token Hunyuan is matched case-insensitively. robots.txt alone may not stop Hunyuan, so add the Nginx, Apache or Cloudflare rule as well.
robots.txt: block
# Block Hunyuan
User-agent: Hunyuan
Disallow: /robots.txt: allow
# Allow Hunyuan
User-agent: Hunyuan
Allow: /robots.txt: partial
# Keep Hunyuan out of private areas only
User-agent: Hunyuan
Disallow: /wp-admin/
Disallow: /cart/
Disallow: /checkout/
Disallow: /my-account/
Allow: /Nginx
# Nginx: return 403 to Hunyuan
if ($http_user_agent ~* "(Hunyuan)") {
return 403;
}Apache
# Apache .htaccess: return 403 to Hunyuan
RewriteEngine On
RewriteCond %{HTTP_USER_AGENT} (Hunyuan) [NC]
RewriteRule .* - [F,L]Cloudflare WAF
# Cloudflare > Security > WAF > Custom rule, action: Block
(http.user_agent contains "Hunyuan")How to verify real Hunyuan traffic
Tencent publishes no IP list or reverse DNS pattern for Hunyuan, so the user agent cannot be verified. Anyone can send the same string. Rate-limit unusual volume instead of trusting the name.
How to find Hunyuan in your server logs
Search the web server access log for the token. The command below counts Hunyuan requests per URL on Nginx or Apache.
grep -i "Hunyuan" access.log | awk '{print $7}' | sort | uniq -c | sort -rn | head -20For a full report per AI bot, upload the log to the AI Log File Analyzer, a free tool by Justin Hà.
Hunyuan FAQ
Hunyuan uses the robots.txt token "Hunyuan". Tencent does not publish a full user-agent string, so match the token inside the User-Agent header.
Tencent has not documented how Hunyuan treats robots.txt. Add a robots.txt rule and back it with a server rule if the traffic matters to you.
Blocking an AI training crawler has no effect on Google or Bing rankings. Blocking keeps your future pages out of that company's training data, so its models may know less about your brand over time. It does not remove you from that company's AI search, which uses a separate bot.
Add two lines to the robots.txt file at the root of each domain and subdomain: "User-agent: Hunyuan" followed by "Disallow: /". The token is case-insensitive. Changes can take up to 24 hours to be picked up.
Not reliably. Tencent publishes no IP list or reverse DNS pattern for Hunyuan, so anyone can send the same user agent. Rate-limit unusual volume instead of trusting the name.
Search your server access log for "Hunyuan", for example with: grep -i "Hunyuan" access.log. The AI Log File Analyzer by Justin Hà counts visits per AI bot from an uploaded log file.
Sources: Public bot registry. Last reviewed by Justin Hà.
See which of these bots actually reach your website
The AI Log File Analyzer by Justin Hà counts visits from GPTBot, ClaudeBot, PerplexityBot and other AI crawlers in your server log, for free. The GEO Technical Package sets up robots.txt, llms.txt and crawler access for AI search.
