Search Data Hub content with a phrase and filters, then return matching page records with source metadata and content text.
Web Search Rerank
Search the web from a natural-language request and return relevance-ranked webpage results with content and source metadata
Descripción general
Web research often starts with a question rather than a known page. This Data App turns a natural-language request into a relevance-ranked set of webpages, preserving the page text, concise summaries, source identity, and publication context needed for analysis.
It is useful for quickly building a research set around a company, product, topic, or event. Freshness and domain filters help focus the search, while account, organization, and search-role filters can narrow the results when those source attributes are available.
Data notes
Each row represents one webpage returned for the submitted search question. Page URL is used to identify a result and remove duplicates. The result set covers webpage records only; a separate image collection returned by the source is not included here.
Page content may be empty even when a title, snippet, or summary is available. Account name, organization name, site icon, cached URL, language, and family-friendly or navigational flags may also be unavailable for individual pages. Publication and crawl timestamps are preserved as source text without inferring a timezone.
What the results look like
Each row is one relevance-ranked webpage result.
| Page URL | Page title | Site name | Published at | Snippet |
|---|---|---|---|---|
| https://www.example.com/article/123 | Xiaomi car delivery momentum continues to rise | Example Site | 2026-08-05 14:23:10 | Xiaomi car deliveries have continued to grow. |
Additional values include the full page content, summary, display and cached URLs, account and organization names, language, source identifiers, and crawl time.
Use cases
- Build a research set for a company, product, market, or event by combining Page title, Page content, Snippet, and Summary.
- Monitor recent coverage by pairing a Freshness filter with Published at and Last crawled at.
- Compare source visibility by grouping results by Site name, Account name, or Organization name.
- Preserve traceable source links by using Page URL and Display URL when reviewing or exporting results.
Alcance y límites
Each run accepts one natural-language search request and returns up to 200 relevance-ranked webpage records in one response. Separate image results are not included.
- Adecuada para
- When you need relevance-ranked webpage results for a natural-language research question
- When you need webpage titles, summaries, content, source metadata, and publication timestamps in a structured result set
- When you want to narrow web search by freshness, domains, account, organization, or search role
- No usar para
- When you need image-only results or a dedicated image search dataset
- When you need private, login-only, or non-public webpage content
Gestión de fallos
Comportamiento de fallos y reintentos declarado por el desarrollador. Recomendamos incluirlo en tu prompt del sistema al integrar.
- 1If no useful webpages are returned, broaden the query or remove restrictive domain and freshness filters
- 2Retry later after rate limiting, temporary service unavailability, or a timeout
- 3If authentication fails, verify the API Key configured for the execution environment
Entrada
Parámetros necesarios para llamar a esta App, generados a partir del input.schema del manifest.json.
- Search question
queryObligatoriostringThe natural-language topic or question to search. Provide at least one character; clearer wording produces more focused results.EjemploXiaomi car delivery and sales performance - Result count
countOpcionalintegerThe number of webpage results to request. The default is 10 and the allowed range is 1 to 200; fewer results may be available for a narrow query.Rango1–200Predeterminado10 - Freshness filter
freshnessOpcionalstringLimits results by recency. Use noLimit, oneDay, oneWeek, oneMonth, oneYear, a date such as 2026-08-05, or a date range such as 2026-08-01..2026-08-31. The default is noLimit.PredeterminadonoLimit - Included domains
includeOpcionalstringSearch only the listed domains. Separate up to 100 domain values with | or commas, using domain values supplied by the Data Hub domain list. - Excluded domains
excludeOpcionalstringExclude the listed domains from the search. Separate up to 100 domain values with | or commas, using domain values supplied by the Data Hub domain list. - Account name
account_nameOpcionalstringFilters results to an exact account name when the source identifies one. Leave empty to search without an account filter. - Organization name
office_nameOpcionalstringFilters results to an exact organization name when the source identifies one. Leave empty to search without an organization filter. - Search role
role_codeOpcionalstringUses a configured Data Hub search role, such as WEB_SEARCH. Leave empty to use the system default role.
Salida
Estructura de campos de un único registro, generada a partir del output.schema del manifest.json.
- Account name
account_namestringThe account name associated with the webpage when available.EjemploChina News Network - Cached page URL
cached_page_urlstringThe cached webpage URL when available. - Page content
contentstringThe webpage body content when available. It is independent from the snippet and summary and may be empty.EjemploXiaomi car deliveries have continued to grow, with stronger showroom traffic and steady delivery scheduling. - Last crawled at
date_last_crawledstringThe source timestamp of the latest crawl, preserved as returned without timezone conversion.Ejemplo2026-08-05 15:00:00
Datos de ejemplo
Generado a partir de output.schema. Los campos sin valor de ejemplo usan marcadores de estructura.
{
"account_name": "China News Network",
"cached_page_url": "<cached_page_url>",
"content": "Xiaomi car deliveries have continued to grow, with stronger showroom traffic and steady delivery scheduling.",
"date_last_crawled": "2026-08-05 15:00:00",
"date_published": "2026-08-05 14:23:10",
"display_url": "https://www.example.com/article/123",
"id": "0",
"is_family_friendly": false,
"is_navigational": false,
"language": "en",
"name": "Xiaomi car delivery momentum continues to rise",
"office_name": "<office_name>",
"site_icon": "<site_icon>",
"site_name": "Example Site",
"snippet": "Xiaomi car deliveries have continued to grow.",
"summary": "Xiaomi car deliveries have continued to grow, with stronger showroom traffic and steady delivery scheduling.",
"url": "https://www.example.com/article/123"
}Integración
Esta App se puede integrar mediante MCP, API, SDK o exportación de archivos — todos los canales comparten las mismas capacidades y precios. Cada solicitud se autentica con la cabecera Authorization: Bearer usando una API Key (de larga duración, creada en la consola de Data Hub); los clientes MCP también pueden iniciar sesión con OAuth sin clave. Más opciones como CLI y Skill están en camino.
Con MCP (Model Context Protocol) puedes llamar a esta App directamente desde clientes de IA como Claude y Cursor. Elige tu cliente y el modo de autenticación, y copia la configuración de abajo.
Configuración del cliente
Sustituye el valor tras Bearer por tu API Key de larga duración. Funciona en cualquier cliente, CI o entorno sin interfaz.
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/data-hub-web-search-rerank",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}Deja que la IA lo configure por ti
¿No quieres editar configuraciones a mano? Copia el prompt de instalación y pégalo en cualquier cliente de IA: completará la configuración a su manera. (De forma predeterminada te guía para iniciar sesión y nunca te pide que envíes tu API Key en el chat.)
detail.access.mcp.composeHint
Precios
Se cobra según el número de registros devueltos correctamente. Las ejecuciones fallidas no se cobran. Se factura en unidades de 50 registros; cualquier unidad parcial se redondea a 50 registros.
Los distintos eventos de facturación se acumulan de forma independiente. Consulta cada elemento para más detalles. Las ejecuciones fallidas no se cobran.
Ver créditosPruébalo ahora
Rellena los parámetros y ejecuta — los resultados provienen de una llamada real.