Hacker News

用途：搜索和浏览 Hacker News，覆盖故事、评论、用户与招聘线程。\n\n主要能力：提供两套 API。官方 HN API 基址为 https://hacker-news.firebaseio.com/v0，适合单条内容与实时数据，包含 /topstories.json（前 500 条故事 ID）、/newstories.json、/beststories.json、/askstories.json、/showstories.json、/jobstories.json，以及 /item/{id}.json 与 /user/{username}.json。Algolia Search 基址为 https://hn.algolia.com/api/v1，适合全文搜索与过滤，语法为 /search?query=TERM&tags=TAG&numericFilters=FILTER；标签可组合（story、comment、poll、job、ask_hn、show_hn、author_USERNAME、story_ID），数值过滤支持 created_at_i>TIMESTAMP、points>N、num_comments>N。\n\n常用模式：首页取 /topstories.json 后抓取前 30 条；搜帖用 /search?query=X&tags=story；用户帖子用 /search?tags=author_USERNAME；招聘帖用 /search?query=who is hiring&tags=story,author_whoishiring；故事评论用 /search?tags=comment,story_ID；本周热门用 /search?tags=story&numericFilters=created_at_i>WEEK_TS。\n\n响应处理：官方 API 返回 ID 列表，需并行批量抓取条目；Algolia 直接返回含 hits[] 的完整对象。故事对象字段为 id、title、url、score、by、time、descendants；评论对象字段为 id、text、by、parent、time。\n\n限制与注意：官方 API 无需鉴权、限额宽松；Algolia 每小时 10,000 次请求，无需密钥；大结果需分页（page=N、hitsPerPage=N）。注意 Ask HN/Show HN 文本帖的 url 为 null，应改用 text 字段；存在 deleted 与 dead 条目，展示前需检查；时间戳为 Unix 秒而非毫秒；Algolia 的 objectID 等于 HN 条目 id（字符串形式）。\n\n参考文件：api.md（API 端点）、search.md（搜索模式）。其他平台与收费信息暂未提供。