jisu-news_skill

Overview

This skill connects to the Jisu News API to fetch lists of hot news by channel (headlines, finance, sports, entertainment, etc.) and to list available channels. It requires a JISU_API_KEY environment variable and returns structured news items (title, time, source, category, content, urls, and images). Designed for quick integration into agents that need timely news snippets and links.

How this skill works

The skill calls two Jisu API endpoints: one to retrieve the catalog of available channels and another to fetch news items for a specified channel with pagination parameters (num, start). It validates the channel, sends the request with your appkey, and normalizes the API response into a consistent list of items that include title, time, src, weburl, and optional picture and content. The skill surfaces API error codes so the caller can handle missing channels, empty results, or key/permission issues.

When to use it

• When an agent must show current headlines or topic-specific news (e.g., finance, sports, tech).
• When you need a quick channel list to present options to users before fetching items.
• To fetch a compact set of articles for summarization, alerting, or daily briefing generation.
• When you need article metadata and URLs for citation or follow-up retrieval.
• When building dashboards or chat responses that include up-to-date news links.

Best practices

• Set JISU_API_KEY as an environment variable and validate it before calls to avoid obvious failures.
• Check available channels first, then request only supported channels to prevent API error 201 (channel not found).
• Limit num to practical values (default 10, max 40) and use start for paging to avoid large responses.
• Handle common API/system error codes (101–105, 201, 202, 205) and provide fallbacks or user-friendly messages.
• Treat returned content as third-party material; include source attribution and respect copyright — link to weburl or source rather than republishing full content.

Example use cases

• User asks “What are today’s top tech headlines?” — list channels, select “Technology”, fetch top 10 items, summarize titles with weburl links.
• Automated daily briefing — fetch top finance and headlines channels, extract title/time/src, assemble a short report or email.
• Content curation dashboard — paginate through specific channels (e.g., NBA, stocks) and display images and source links for editors to review.
• Chatbot fallback for news queries — confirm channel availability, fetch recent items and present quick facts and links for deeper reading.