# you_contents

tool by [@c0va23](/marketplace/@c0va23/tools)

A tool that fetches ydc-index.io.

- First published 2026-10-27 · release 2 on 2026-10-28
- [Download release 2](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/latest.bylm.json)
- [0 stars](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/stars)
- Needs a key: **You.com** — sent to https://ydc-index.io. Hint: Dashboard: sign in at you.com/platform, create an API key, and paste it here. [Get a key](https://you.com/platform/api-keys)

## What it holds

### What the model is told

**Tool the model sees**: `fetch_url-you_contents`

```text
Fetch the full text of specific web pages as clean Markdown with the You.com Contents API (POST https://ydc-index.io/v1/contents). Use after a search when you need the whole body of particular result URLs, or when the user gives you URLs to read.
```

### Request

**Method and address**: `POST https://ydc-index.io/v1/contents`

**Headers sent**:

- `X-API-Key: {secrets.apiKey}`

**Body**: `application/json`

```json
{
  "urls": {urls},
  "formats": ["markdown"]
}
```

**Accepted responses**: `application/json`

### Arguments the model passes

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `urls` | list of string | yes |  | Absolute http(s) URLs of the pages to read, one to a few per call (e.g. \["https://example.com/article"\]). |

### Responses

**Statuses that are errors**: 400 to 599

**A response filtered to nothing is an error**: no

**What the model reads for an error**: The status line, then the body

**Retries**: A 429 or a 503 is sent again, 3 times at most, waiting 1000 ms first and doubling, 60000 ms at most

**Kept for the app's response details screen**: the first 65536 characters of the body and of each filter's output; the model never reads them

**Cost, in US dollars, read by a jq program**:

```
select($status == 200) | (0.001 * (length // 0))
```

An expression that fails records nothing and keeps the response.

### Filters over the response, in order

#### Step 1

A jq program, giving `text/markdown`

```
def body: (.markdown // "") as $m | if ($m | length) > 30000 then ($m[0:30000] + "\n\n[... page truncated here; it had " + (($m | length) | tostring) + " characters]") else $m end;
map("### " + (.title // "(untitled)") + "\nURL: " + (.url // "") + "\n\n" + (if (.markdown // "") == "" then "(no readable content returned for this URL)" else body end))
| if length == 0 then "No page content was returned." else join("\n\n---\n\n") end
```

When the program outputs several values, only the first is passed on. A string is passed on without its quotes.

### Keys

**`apiKey`**: **You.com**, an API key

## Downloads

Downloaded 7 times directly. Included in 3 downloads of other listings. 7 downloads in the last 30 days.

## Releases

| Release | Published | Downloads | File |
| --- | --- | --- | --- |
| [2](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/releases/2) | 2026-10-28 | [4](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a?release=2) | [download](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/v/2.bylm.json) |
| [1](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/releases/1) | 2026-10-27 | [3](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a?release=1) | [download](/marketplace/listings/01a17b91-c23d-75fa-8883-dc23dcbecf0a/v/1.bylm.json) |

---

[Bring Your LM](/) · [Docs](/docs/features) · [Marketplace](/marketplace)

[Articles](/articles) · [Releases](/releases) · [Bundle Format](/marketplace/bundle-format) · [Marketplace Terms](/terms) · [App Privacy](/privacy) · [Website Privacy](/website-privacy) · [Open Source](/open-source) · [llms.txt](/llms.txt)