Use trpfrog.net when a task is about tsmami (trpfrog) or the posts on this site.
つまみネットと関係のない一般的な調べものには向いていません。
Accept: text/markdown を付けてリクエストすると、同じ URL で Markdown が返りますhttps://trpfrog.net/blog/<slug>.md でも取得できますhttps://trpfrog.net/llms.txt、ページの一覧は https://trpfrog.net/sitemap.xml にあります認証不要・読み取り専用の REST API です。OpenAPI の定義は https://trpfrog.net/api/v1/openapi.json にあります。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /api/v1/blog/posts?q=<キーワード>&tag=<タグ>&limit=<件数> | 記事を新しい順に検索する |
| GET | /api/v1/blog/posts/<slug> | 記事のメタデータと Markdown 本文 |
| GET | /api/v1/blog/tags | タグと記事数 |
| GET | /api/v1/health | 稼働状況 |
curl 'https://trpfrog.net/api/v1/blog/posts?q=徒歩&limit=5'エラーは RFC 9457 の application/problem+json で返し、code に機械可読なエラーコードを入れます。
| code | ステータス | 意味 |
|---|---|---|
invalid_query | 400 | クエリパラメータが不正 |
post_not_found | 404 | 指定した slug の記事がない |
route_not_found | 404 | 存在しないエンドポイント |
internal_error | 500 | 予期しないエラー |
互換性のない変更はパスのメジャーバージョン (/api/v1, /api/v2, ...) を上げて行います。
古いバージョンを廃止するときは、90 日以上前から Deprecation と Sunset ヘッダーで告知します。
Streamable HTTP の MCP サーバーが https://trpfrog.net/mcp にあります (認証不要)。
| ツール | 説明 |
|---|---|
search_blog_posts | 記事をキーワード・タグで検索する |
get_blog_post | 記事の Markdown 本文を読む |
list_blog_tags | タグと記事数を一覧する |
get_site_overview | サイトと著者の概要、最新記事 |
claude mcp add --transport http trpfrog-net https://trpfrog.net/mcphttps://trpfrog.net/.well-known/api-cataloghttps://trpfrog.net/mcp/server-cardhttps://trpfrog.net/.well-known/agent-skills/index.json