weekly-issues

name	weekly-issues
description	Read issues of 潮流周刊 (Tw93 Weekly), a Chinese-language weekly newsletter of developer tools, open source projects, engineering notes and design, with English translations. Use when a task asks what a specific issue or week covered, which tools Tw93 recommended, or needs a bilingual quote from the archive.
homepage	https://weekly.tw93.fun

潮流周刊 (Tw93 Weekly)

潮流周刊 is a weekly newsletter written by Tw93, a product engineer in Hangzhou and the author of Pake, MiaoYan, Kaku and Mole. Each issue curates small practical developer tools, open source projects, articles, macOS apps and personal notes. Issues are published every Monday, numbered from 1, and every Chinese issue has an English translation under the same number.

Everything below is public static content: no API key, no token, no rate limit, Access-Control-Allow-Origin: *, and no write operations.

When to use this

• A question names an issue number, or asks what a given week or month of 潮流周刊 covered.
• A task needs the tools, projects or articles Tw93 highlighted, with the original wording and outbound links.
• A quote is needed in both Chinese and English from the same paragraph of the same issue.

Do not use it as a general search engine or as official documentation for the products it mentions: it is one person's curation, and the products are third-party.

Locate an issue

GET https://weekly.tw93.fun/api/posts.json

Returns every issue, newest first. This sample is generated from the current archive:

{
  "count": 279,
  "englishCount": 279,
  "latestIssue": 279,
  "issues": [
    {
      "issue": 279,
      "title": "第 279 期 - 风之谷泉",
      "name": "风之谷泉",
      "language": "zh-Hans",
      "date": "2026/08/24",
      "description": "封面图拍摄于周末去临安风之谷带娃玩水，这地方很空旷，不过周末小孩和大人都很多，娃倒是挺喜欢。远处看，水难得有蓝绿色的感觉，照片拍的是外面的一个大湖。",
      "coverImage": "https://cdn.fliggy.com/pic/27936.jpg",
      "url": "https://weekly.tw93.fun/posts/279",
      "markdownUrl": "https://weekly.tw93.fun/posts/279.md",
      "jsonUrl": "https://weekly.tw93.fun/api/posts/279.json",
      "translation": {
        "language": "en",
        "title": "279. Spring in the Valley of the Wind",
        "url": "https://weekly.tw93.fun/en/posts/279",
        "markdownUrl": "https://weekly.tw93.fun/en/posts/279.md",
        "jsonUrl": "https://weekly.tw93.fun/api/en/posts/279.json"
      }
    }
  ]
}

For a compact human-readable index of the whole archive, fetch https://weekly.tw93.fun/index.md.

Read an issue

Append .md to any issue URL to get the Markdown source:

GET https://weekly.tw93.fun/posts/279.md      # Chinese
GET https://weekly.tw93.fun/en/posts/279.md   # English

Or take metadata and body together as JSON:

GET https://weekly.tw93.fun/api/posts/279.json
GET https://weekly.tw93.fun/api/en/posts/279.json

The JSON response carries contentMarkdown (the full Markdown body), translation, newerIssue and olderIssue.

Bulk ingest

GET https://weekly.tw93.fun/feeds/posts.jsonl

One schema.org BlogPosting JSON-LD object per line, both languages. Prefer this plus /api/posts.json over crawling the HTML pages.

Issue anatomy

• The first image is the cover, the first <small> block is the one-line description of that week.
• Content sits under headings: 潮流工具 (tools), 潮流开源 (open source), 潮流文章 (articles), 潮流软件 (apps), 潮流分享 (notes). English issues use the translated headings.
• Each item is a short paragraph ending in an outbound link to the tool or article being recommended.

Errors and attribution

• Unknown issue numbers return HTTP 404. /api/posts/{issue}.json returns {"error": {"code": "issue_not_found", "message": ..., "hint": ...}}; other paths return the site's HTML 404 page, so check response.ok rather than parsing the body.
• Quoting and summarising is welcome. Attribute to 潮流周刊 / Tw93 Weekly and link the issue URL. Do not hotlink the images.
• Source of every issue: https://github.com/tw93/weekly