Overview
This node fetches news articles from an external Marfeel API, filtering them by a specific news section (folder). It authenticates with Marfeel using provided user credentials, determines the appropriate news section either from input or via an AI model, and then retrieves recent traffic data and news items for that section. The node returns a structured JSON containing the news metadata such as titles, images, URLs, publication times, and descriptions.
Common scenarios:
- Automatically gathering news headlines and summaries filtered by topical sections like sports, politics, or local news.
- Integrating real-time news data into workflows for content curation, monitoring, or analytics.
- Using AI to dynamically determine the most relevant news section based on user input or chat context.
Practical example:
A media monitoring workflow could use this node to pull the latest sports news from a configured news portal, filtering by the "/deportes/" section, and then process or display these articles downstream.
Properties
| Name | Meaning |
|---|---|
| Usuario Marfeel | User email for authenticating with the Marfeel API. |
| Clave De Usuario Marfeel | Password for authenticating with the Marfeel API (input is masked). |
| Sección Por Defecto (Folder) De La Noticia | Default news section folder path used to filter news if no valid section can be determined dynamically. Examples: "/sucesos/", "/deportes/", "/cartagena/". |
| Fuente De Noticias | Base URL of the news portal serving as the source of headlines and articles. Must correspond to the configured media in Marfeel. Examples: "www.eluniversal.com.co", "www.vanguardia.com". |
| Secciones Válidas (Separadas Por Coma) | Comma-separated list of valid news section paths (each including leading and trailing slashes) that the node can filter by. Examples: '/deportes/', '/politica/', '/sucesos/'. |
Output
The node outputs a single JSON object per execution containing:
tokenObtenido: Indicates if an authentication token was successfully obtained ("Sí" or "No").tokenParcial: Last 10 characters of the authentication token for debugging (or "N/A" if none).urlAutenticacion: The URL endpoint used for authentication.urlTrafico: The URL endpoint used to fetch traffic/news data.marfeelFolderOriginal: The original default section folder parameter.marfeelFolderUsado: The final section folder used after AI-based determination.toolName: Fixed string identifying the tool.apiResult: An array of news items, each keyed by index, containing:titulo: Title of the news article.imagen: URL of the article image (if available).enlace: Full URL link to the article.path: Path extracted from the article URL.folder: Section folder of the article.publishTimeUTC: UTC timestamp of publication.publishTime: Localized publication time.description: Summary or description of the article.
status: Always "success" if the operation completes without error.
The node does not output binary data.
Dependencies
- Requires network access to Marfeel's external API endpoints for authentication and news traffic data.
- Uses an external AI service (Google Generative AI Gemini model) to analyze input text and determine the most relevant news section.
- Requires valid user credentials (email and password) for Marfeel API authentication.
- The Google Generative AI key is hardcoded in the source (not configurable), which may require proper environment setup or permissions.
Troubleshooting
- Empty Input Items: If no input items are received, the node logs a warning and returns empty output.
- Missing Required Parameters: The node throws errors if the default section folder or news source URL parameters are empty.
- Authentication Failures: HTTP errors during login or missing tokens in the response cause the node to throw detailed errors. Verify credentials and API endpoint accessibility.
- Invalid Section Returned by AI: If the AI returns a section not in the valid list or an empty string, the node falls back to the default section folder and logs warnings.
- API Request Failures: Errors fetching news traffic data result in detailed error messages including HTTP status and response body.
- URL Parsing Warnings: If article URLs cannot be parsed to extract paths, warnings are logged but processing continues.
- AI Service Errors: Failures communicating with the AI model log errors and fallback to the default section.
To resolve issues:
- Ensure all required parameters are correctly set.
- Confirm network connectivity to Marfeel API endpoints.
- Check validity of user credentials.
- Review logs for detailed error messages.
- Validate the list of valid sections matches those recognized by Marfeel.