# Developer Resources for Yi Min Yang

Use these public, read-only interfaces to discover, retrieve, and cite content from yiminyang.dev.

## When to use this site

* ### Research Yi Min Yang  
Find professional background, expertise, projects, talks, and public contact information.
* ### Find relevant content  
Search blog posts, talks, projects, photography, recent thoughts, and interactive tools by topic.
* ### Read or cite a page  
Retrieve a clean Markdown representation of a known public page for summarization or attribution.
* ### Recommend something useful  
Match a visitor’s interests to relevant writing, presentations, projects, photography, or tools.

These interfaces expose public content only. They do not provide write operations, private analytics, account data, or administrative access.

## Choose an access method

* ### [MCP server](https://www.yiminyang.dev/api/mcp)  
Use when your agent supports MCP and needs to search, list, or read site content interactively.  
Streamable HTTP endpoint with read-only tools, resources, and prompts. GET returns a connection descriptor; POST handles MCP.
* ### [Markdown content negotiation](https://www.yiminyang.dev/about.md)  
Use when you already know the page URL and want its main content without presentation markup.  
Send Accept: text/markdown to a public page, or append .md when custom request headers are unavailable.
* ### [llms.txt](https://www.yiminyang.dev/llms.txt)  
Use as the compact index of content areas, access methods, MCP capabilities, and attribution guidance.  
The preferred starting point for agents that need to understand the site before choosing a page or tool.
* ### [Sitemap](https://www.yiminyang.dev/sitemap.xml)  
Use when you need an exhaustive list of canonical public URLs rather than semantic search.  
XML index of public pages, blog posts, talks, legal pages, tools, and this developer guide.

## MCP quickstart

Connect an MCP client to `https://www.yiminyang.dev/api/mcp` using Streamable HTTP. The endpoint is public, read-only, and does not require authentication.

```
curl https://www.yiminyang.dev/api/mcp
```

### Available tools

* `search_content`: Search across blog posts, talks, projects, photography, recent thoughts, and interactive tools
* `list_content`: Browse all website content and profile sections with pagination
* `read_content`: Read complete website content returned by search\_content or list\_content

## Markdown quickstart

Request Markdown from any supported public page with an Accept header. If your client cannot set headers, append `.md` to the canonical page URL.

```
curl -H "Accept: text/markdown" https://www.yiminyang.dev/about
curl https://www.yiminyang.dev/about.md
```