Ttech query news

ttech-query-news

Efficiently query real-time, precise tech news via the TTech.xin platform RESTful API (TTech.xin is a website designed for Agents).

Capabilities

Capability	Endpoint	Description
News List	GET /news	Filter and return news list by date and topic keywords; each entry includes ID, title, summary, source, and involved companies, supports pagination and recent N items
News Details	GET /news/{news_id}	Query details of a news item, adding full text and related news titles/summaries on top of the news list
News Briefings	GET /news/briefings	Query daily / weekly / monthly briefings by time, including TOP10 facts, core opinions, and suggestions for practitioners

Not Applicable Scenarios

• Non-tech general news (e.g., politics, entertainment, sports, social livelihood);
• Static tech knowledge Q&A from the distant past (unless the user explicitly specifies a historical review);
• For stock prices and news about a single company, prefer using the query-tech-company SKILL; otherwise use this SKILL.

General Conventions

Base URL: https://ttech.xin/api/v1.0

Response Format:

{
  "code": 0,
  "message": "success",
  "data": { ... },
  "meta": { "request_id": "...", "timestamp": 1713423456789 }
}

Common Parameters:

Parameter	Default	Description
lang	en	zh / en
page	1	Page number, starting from 1
page_size	See endpoint	Items per page

Detailed References

This SKILL includes the following reference documents:

File	Purpose	When to Read
reference.md	Detailed API parameters and response fields	When you need to deeply understand API parameters and the meaning of each field in the response body
examples.md	Scenario-based complete calling examples	When you need to use complex API parameters or combine multiple API calls, especially when previous results did not match user expectations
scripts/call_api.js	Recommended API calling script	When you need to execute API calls

Endpoint Quick Reference

1. Get News List

GET /news?start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}&subject={keywords}&page={N}&page_size={N}&limit={N}&lang={zh/en}

Return real-time or historical news by date and topic keywords, returning news ID, title, summary, source, and involved companies. Can get recent N items via limit, or get the full news list via pagination.

Query several instant news items

GET /news?limit={N}&lang={zh/en}

Query all news within a time range

GET /news?start_date={YYYY-MM-DD}&end_date={YYYY-MM-DD}&page={N}&page_size={N}&lang={zh/en}

Query all news related to a tech topic

GET /news?subject={keywords}&page={N}&page_size={N}&lang={zh/en}

2. Get News Details

Query details of a news item, adding full text and related news titles/summaries on top of the news list. news_id can be obtained from the News List API response body.

GET /news/{news_id}?lang={zh/en}

3. Get News Briefings

Query daily / weekly / monthly briefings by time. Returned content includes TOP10 facts, core opinions, and suggestions for practitioners. Daily briefing is a summary of news from the previous day's early morning to 9:00 AM of the current day; weekly briefing is a summary of the 7 daily briefings of the current week; monthly briefing is a summary of all daily briefings of the current month.

GET /news/briefings?interval={enum}&date={YYYY-MM-DD}&lang={zh/en}

interval: daily | weekly | monthly

API calling rules:

• Daily: interval=daily, date is today's date;
• Weekly: interval=weekly, date is Sunday's date of the week;
• Monthly: interval=monthly, date is the last day of the month;

Tool Usage

Use the exec tool to run API calls via the bundled Node.js script:

node scripts/call_api.js 'https://ttech.xin/api/v1.0/news?lang=en&page=1&page_size=20' -H 'Accept: application/json'

Key conventions:

1. No authentication: read endpoints are publicly accessible
2. Date format: YYYY-MM-DD
3. Pagination strategy: prefer limit to get recent N items; use page + page_size for pagination
4. Language switch: when the user requests Chinese, set all lang to zh