Registro de atualizações do User-Agent
Esta página reúne o histórico de atualizações do User-Agent compatível com o CapMonster Cloud. Aqui você pode saber mais sobre a nova versão, obter o valor atual e conferir exemplos de uso em solicitações de API, automação de navegadores e diferentes linguagens de programação.
O CapMonster Cloud atualiza regularmente o User-Agent compatível. O CapMonster Cloud atualiza regularmente o User-Agent compatível. Você pode acompanhar o lançamento de novas versões nesta seção do blog, no fórum, na documentação e nos canais oficiais do Telegram ZennoLab e CapMonster Cloud.
Usar o valor atual ajuda a garantir a consistência dos parâmetros da tarefa, aumentar a estabilidade do processamento de CAPTCHAs e reduzir a probabilidade de erros relacionados a dados desatualizados do navegador.
Importante: para trabalhar com o CapMonster Cloud, é necessário usar não apenas a versão mais recente lançada do Chrome, mas o User-Agent que é atualmente compatível com o serviço.
O valor atual do User-Agent pode ser obtido automaticamente a qualquer momento por meio da API (método de solicitação: GET):
https://capmonster.cloud/api/useragent/actual
Histórico de atualizações do User-Agent
| Versão | Data de atualização | User-Agent |
|---|---|---|
150 Atual | 16.07.2026 | |
| 149 | 17.06.2026 | |
| 148 | 20.05.2026 | |
Mostrar todas as versões
| 147 | 07.05.2026 | |
| 146 | 31.03.2026 | |
| 145 | 27.02.2026 | |
| 144 | 29.01.2026 | |
| 143 | 19.12.2025 | |
| 142 | 11.11.2025 | |
| 141 | 13.10.2025 | |
| 140 | 17.09.2025 | |
| 139 | 21.08.2025 | |
| 138 | 15.07.2025 | |
| 136 | 14.05.2025 | |
| 135 | 15.04.2025 | |
| 134 | 31.03.2025 | |
| 133 | 13.02.2025 | |
| 132 | 29.01.2025 | |
| 131 | 19.11.2024 | |
| 130 | 23.10.2024 | |
| 129 | 27.09.2024 | |
| 128 | 30.08.2024 | |
O que é User-Agent
User-Agent – é uma string que o navegador ou outro cliente HTTP envia ao site junto com a solicitação. Ela contém informações sobre o navegador, o sistema operacional e o mecanismo utilizado.
Exemplo:
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36Essa string indica que a solicitação é realizada em nome do navegador Chrome em uma versão de 64 bits do Windows.
O User-Agent pode ser utilizado pelo site juntamente com outros parâmetros do cliente: cabeçalhos HTTP, cookies, endereço IP, configurações do navegador e resultados da execução de JavaScript. Por isso, ele deve ser consistente com os demais parâmetros da sessão.
Por que o CapMonster Cloud atualiza o User-Agent
As versões dos navegadores mudam regularmente e, junto com elas, são atualizados os valores utilizados na criação de sessões do navegador e no envio de solicitações.
O uso de um User-Agent desatualizado ou não compatível pode reduzir a estabilidade da resolução de CAPTCHAs ou causar erros adicionais.
Não é recomendado criar a string manualmente, inserir uma versão aleatória ou considerar apenas a versão mais recente do Chrome. Uma nova versão do navegador pode já existir, mas ainda não ser compatível com o serviço.
Obtenção e uso do User-Agent
O User-Agent atual pode ser obtido por meio da API do CapMonster Cloud:
JavaScript
const response = await fetch(
"https://capmonster.cloud/api/useragent/actual",
);
if (!response.ok) {
throw new Error(
`Falha ao obter o User-Agent atual: ${response.status}`,
);
}
const userAgent = (await response.text()).trim();
console.log("User-Agent atual:", userAgent);Python
import requests
response = requests.get(
"https://capmonster.cloud/api/useragent/actual",
timeout=30,
)
response.raise_for_status()
user_agent = response.text.strip()
print("User-Agent atual:", user_agent)C#
using System.Net.Http;
using var httpClient = new HttpClient();
var userAgent = (
await httpClient.GetStringAsync(
"https://capmonster.cloud/api/useragent/actual"
)
).Trim();
Console.WriteLine($"User-Agent atual: {userAgent}");cURL
curl https://capmonster.cloud/api/useragent/actual
Ferramentas de automação
O valor obtido pode ser usado ao criar um contexto do navegador em ferramentas de automação e navegadores headless, por exemplo, no Playwright:
import { chromium } from "playwright";
const response = await fetch(
"https://capmonster.cloud/api/useragent/actual",
);
if (!response.ok) {
throw new Error(
`Falha ao obter o User-Agent: ${response.status}`,
);
}
const userAgent = (await response.text()).trim();
const browser = await chromium.launch({
headless: false,
});
const context = await browser.newContext({
userAgent,
});
const page = await context.newPage();
await page.goto("https://example.com");
Para simular completamente a versão necessária do User-Agent, também é necessário configurar os valores correspondentes de Client Hints, incluindo os cabeçalhos Sec-CH-UA:
Mostrar código Ocultar código
import { chromium } from "playwright";
const response = await fetch("https://capmonster.cloud/api/useragent/actual");
if (!response.ok) {
throw new Error(`Falha ao obter o User-Agent: ${response.status}`);
}
const userAgent = (await response.text()).trim();
console.log("User-Agent recebido da API:", userAgent);
// Extraímos a versão completa e a versão principal do Chrome
const chromeVersionMatch = userAgent.match(/Chrome\/(\d+(?:\.\d+){0,3})/);
if (!chromeVersionMatch) {
throw new Error("Falha ao extrair a versão do Chrome do User-Agent.");
}
const fullVersion = chromeVersionMatch[1];
const majorVersion = fullVersion.split(".")[0];
const browser = await chromium.launch({
headless: false,
devtools: true,
});
const context = await browser.newContext();
const page = await context.newPage();
const cdpSession = await context.newCDPSession(page);
await cdpSession.send("Emulation.setUserAgentOverride", {
userAgent,
platform: "Win32",
userAgentMetadata: {
brands: [
{
brand: "Chromium",
version: majorVersion,
},
{
brand: "Google Chrome",
version: majorVersion,
},
{
brand: "Not_A Brand",
version: "99",
},
],
fullVersionList: [
{
brand: "Chromium",
version: fullVersion,
},
{
brand: "Google Chrome",
version: fullVersion,
},
{
brand: "Not_A Brand",
version: "99.0.0.0",
},
],
fullVersion,
platform: "Windows",
platformVersion: "10.0.0",
architecture: "x86",
model: "",
mobile: false,
bitness: "64",
wow64: false,
},
});
await page.goto("https://example.com", {
waitUntil: "networkidle",
});
// Verificamos os valores no contexto do navegador
const browserData = await page.evaluate(async () => {
const highEntropyValues = await navigator.userAgentData?.getHighEntropyValues(
[
"architecture",
"bitness",
"fullVersionList",
"mobile",
"model",
"platform",
"platformVersion",
"wow64",
],
);
return {
userAgent: navigator.userAgent,
userAgentData: navigator.userAgentData
? {
brands: navigator.userAgentData.brands,
mobile: navigator.userAgentData.mobile,
platform: navigator.userAgentData.platform,
...highEntropyValues,
}
: null,
};
});
console.log("Dados do navegador:", JSON.stringify(browserData, null, 2));
if (browserData.userAgent !== userAgent) {
throw new Error(
"O User-Agent do navegador não corresponde ao valor recebido da API.",
);
}
console.log(
"O User-Agent e os Client Hints estão configurados. Abra a aba Network nas DevTools e recarregue a página para verificar os cabeçalhos da requisição.",
);
Isso permite abrir a página com a versão necessária do User-Agent, mesmo que a versão do Chromium instalada no Playwright seja diferente.
Como passar o User-Agent para uma tarefa
O valor obtido deve ser passado no campo userAgent, se ele for compatível com o tipo de tarefa selecionado.
{
"clientKey": "API_KEY",
"task": {
"type": "ExampleTask",
"websiteURL": "https://example.com",
"websiteKey": "SITE_KEY",
"userAgent": "USER_AGENT_FROM_ENDPOINT"
}
}No lugar de USER_AGENT_FROM_ENDPOINT, insira a string obtida por meio do endpoint da API.
Exemplo com reCAPTCHA v2:
{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV2Task",
"websiteURL": "https://yourwebsite.com/page-with-recaptcha",
"websiteKey": "your-website-key",
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/150.0.0.0 Safari/537.36"
}
}O conjunto exato de parâmetros depende do tipo de tarefa. Antes da integração, consulte a descrição da CAPTCHA necessária na documentação do CapMonster Cloud.
Consistência do User-Agent durante a sessão
Se a resolução da CAPTCHA (conclusão da verificação) estiver vinculada a uma sessão específica do navegador, o User-Agent deve permanecer inalterado em todas as etapas:
- Obter um valor compatível por meio da API do CapMonster Cloud.
- Passá-lo ao criar a tarefa.
- Usar o mesmo valor no navegador ou cliente HTTP.
- Não alterá-lo em solicitações posteriores durante a mesma sessão.
Por exemplo, não crie uma tarefa com o User-Agent do Chrome 150 e depois use o resultado obtido em uma solicitação com o User-Agent do Chrome 149.
A consistência é especialmente importante quando o User-Agent é usado junto com:
- proxies;
- cookies;
- tokens;
- cabeçalhos do navegador;
- parâmetros da sessão;
- Client Hints.
Os valores de Client Hints, incluindo Sec-CH-UA, Sec-CH-UA-Mobile e Sec-CH-UA-Platform, devem corresponder ao User-Agent principal. Em um navegador real, esses cabeçalhos geralmente são gerados automaticamente, mas, ao enviar solicitações HTTP manualmente, eles devem ser especificados e verificados separadamente.
É especialmente importante manter a consistência dos cabeçalhos ao obter e usar posteriormente cookies (por exemplo, em tarefas com DataDome, Cloudflare Challenge, Imperva, TSPD). Um exemplo de configuração do User-Agent e dos cabeçalhos do navegador, abertura da página e processo completo de resolução dentro de uma única sessão pode ser encontrado nesta seção.
Uso no macOS e Linux
O CapMonster Cloud oferece suporte a User-Agent para Windows, mas isso não significa que ele não possa ser usado em outros sistemas operacionais.
Se o serviço retornar um User-Agent para Windows, use-o em suas solicitações sem alterações, independentemente do sistema operacional do computador ou servidor. Não substitua manualmente o trecho "Windows NT 10.0; Win64; x64" por valores de macOS ou Linux.
Ao trabalhar com ferramentas de automação e configurar Client Hints, é necessário manter a mesma plataforma:
- platform – Win32;
- Sec-CH-UA-Platform – "Windows";
- architecture – x86;
- bitness – 64.
Dessa forma, o User-Agent, os Client Hints e os valores da API JavaScript descreverão uma única sessão de navegador consistente.
Importante: alterar o User-Agent e os Client Hints não transforma o macOS ou Linux em Windows no nível de todo o sistema. Parâmetros como fontes disponíveis, subsistema gráfico, codecs de mídia e outras características do ambiente ainda podem depender do sistema operacional no qual o navegador está sendo executado.
Recomendações
Para trabalhar de forma estável com o User-Agent:
✓ obtenha a string atualizada por meio da API do CapMonster Cloud;
✓ não defina a versão manualmente;
✓ não se baseie apenas na versão mais recente do Chrome;
✓ use o mesmo valor durante toda a sessão;
✓ passe-o para a tarefa se o campo "userAgent" for compatível;
✓ use o mesmo valor nas solicitações subsequentes;
✓ mantenha a consistência com os outros cabeçalhos;
✓ não altere o User-Agent após obter a solução;
✓ atualize a configuração ao criar uma nova sessão.
Links úteis
- Obter o User-Agent atual através da API
- Documentação do CapMonster Cloud
- Métodos da API
- Criação de tarefa
- Obtenção do resultado da tarefa
- Tipos de CAPTCHA suportados
Notícias sobre atualizações do User-Agent:
- fórum ZennoLab
- documentação
- canal oficial do ZennoLab no Telegram
- canal oficial do CapMonster Cloud no Telegram
Perguntas frequentes
