Skip to main content
Glama

AIsa Web Search & Research

BytePlus Fetch

post_byteplus_fetch
Destructive

Fetch a single URL and return clean, structured page content — title, body text, and publish time. Url is required. The response wraps ResponseMetadata.RequestId and a Result object with the parsed content. Use it to extract full page content for URLs you already have, typically pairing it with post_byteplus_web_search results. failed requests are not charged.

Published reference price: $0.0008 USD per successful request. Account-specific pricing and final settlement may differ.

Input Schema

NameRequiredDescriptionDefault
bodyYes

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • addedInput schema / additionalProperties
      Added value: +false
    • removedInput schema / properties / Url
      Removed value: -{
      -  "description": "The URL to fetch. Required.",
      -  "example": "https://example.com",
      -  "type": "string"
      -}
    • addedInput schema / properties / body
      Added value: +{
      +  "properties": {
      +    "Url": {
      +      "description": "The URL to fetch. Required.",
      +      "example": "https://example.com",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "Url"
      +  ],
      +  "type": "object"
      +}
    • changedInput schema / required
      Previous value: -[
      -  "Url"
      -]New value: +[
      +  "body"
      +]
  2. Added
  3. Removed
  4. Added

TDQS

B3.3/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description frames this as a benign read ('Fetch... return clean, structured page content'), yet the annotations declare readOnlyHint=false, destructiveHint=true and idempotentHint=false, and the description never reconciles that. An agent combining both sources cannot tell whether calling this mutates or destroys anything. Per the contradiction rule, this is scored 1 despite otherwise useful detail about the response envelope and billing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and output are front-loaded in the first sentence, followed by required-argument and usage notes in efficient order. The generated pricing comment block and the double space before 'failed requests' add noise, but the prose itself wastes no sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-URL fetch with an output schema, the description covers the required argument, the response envelope, the billing implication of failures, and a companion tool — enough to invoke it correctly. The one real omission is that it does not address or explain the destructive/readOnly annotations, and it ignores competing scrape/extract siblings.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is one parameter at 0% schema description coverage, so the description must carry the load, and it only repeats '`Url` is required' — the same information already in the schema property text. It does not clarify that Url is nested under the required `body` wrapper, nor give accepted URL forms, limits, or timeout/redirect behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Fetch a single URL') plus the concrete output ('title, body text, and publish time'), so an agent knows exactly what it produces. It names one sibling (post_byteplus_web_search) as a companion, but does not distinguish itself from the many other URL-content siblings (post_firecrawl_scrape, post_tavily_extract, post_exa_contents), leaving overlap unresolved.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Use it to extract full page content for URLs you already have, typically pairing it with post_byteplus_web_search results' gives a clear triggering condition and a workflow pairing. It provides no when-not guidance and never explains why an agent should pick this over the equivalent scrape/extract siblings, so the routing question is only half answered.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources