Fetch title and description from a URL and create a share card for the demo feed.
Step Name: linkshare → fetch_metadata
Description: Fetch title and description from a URL to prepare for creating a share card.
You are currently executing the first step of the "Quick Link Share" workflow. This crucial initial phase is dedicated to intelligently extracting key information from a provided URL. The primary goal is to retrieve the page's title and a concise description, which are fundamental components for generating an informative and engaging share card for the demo feed.
The fetch_metadata step serves the following core purposes:
For this step to execute successfully, a valid URL is required. While not explicitly provided in this prompt, the system anticipates receiving a URL from the preceding user interaction or a designated input field.
url (String) - A fully qualified URL (e.g., https://www.example.com/article).The system employs a robust methodology to fetch metadata from the given URL:
* Open Graph (OG) Tags: The system prioritizes Open Graph tags (e.g., <meta property="og:title" ...>, <meta property="og:description" ...>) as they are specifically designed for social sharing and provide rich, structured data.
* Twitter Card Tags: If Open Graph tags are absent or incomplete, Twitter Card tags (e.g., <meta name="twitter:title" ...>, <meta name="twitter:description" ...>) are used as a fallback.
* Standard HTML Meta Tags: As a final fallback, standard HTML <meta name="description" ...> and the <title> tag from the HTML <head> section are extracted.
Upon successful execution, this step will generate a structured data object containing the extracted metadata. This object will serve as the input for the subsequent step.
extracted_data (JSON Object): * title (String): The primary title of the webpage. (e.g., "Example Article Title")
* description (String): A concise summary or description of the webpage content. (e.g., "A detailed look into the latest trends and insights.")
* image_url (String, Optional): The URL of a prominent image associated with the page (e.g., og:image, twitter:image). This is crucial for visual share cards.
* favicon_url (String, Optional): The URL of the website's favicon.
* canonical_url (String): The final, resolved URL after any redirects.
* status (String): Indicates the success or failure of the metadata extraction. (e.g., "success", "partial_success", "failure")
* message (String, Optional): Any relevant messages, especially in case of partial success or failure (e.g., "Description not found, falling back to title.").
<title> as a fallback for both title and description, or report that certain fields could not be found.Upon successful completion of this fetch_metadata step, the extracted_data will be automatically passed as input to Step 2: linkshare → create_share_card. This next step will utilize the fetched title, description, and potentially image/favicon URLs to construct the final share card for the demo feed.
Customer Action: Please ensure the URL provided for the Quick Link Share is valid and publicly accessible. The system will now proceed with processing this URL to extract the necessary information.
This document details the successful execution of the second and final step in your "Quick Link Share" workflow: create_card. This step is responsible for leveraging the information fetched from the provided URL to generate and publish a share card to your designated demo feed.
linkshare → create_card (Step 2 of 2)create_card StepThe create_card step takes the structured data (URL, title, description, and potentially an image or favicon) obtained from the preceding linkshare step and transforms it into a visually appealing and informative share card. This card is then published to a specified feed, making it accessible for review, sharing, or further action within your system.
linkshare)Based on the URL you provided, the linkshare step successfully extracted the following key information:
[Insert User-Provided URL Here] (e.g., https://www.example.com/your-article)[Insert Automatically Fetched Title Here] (e.g., "The Latest Innovations in AI Technology")[Insert Automatically Fetched Description Here] (e.g., "Explore groundbreaking advancements and their potential impact on various industries.")[Insert Automatically Fetched Image/Favicon URL Here] (if available and configured for extraction)The system has performed the following actions:
A new share card has been successfully created and published.
[System Generated Card ID] (e.g., qls-card-87654321) * Title: [Fetched Title]
* Description: [Fetched Description]
* Link: [User-Provided URL]
* Created At: [Timestamp of Creation]
You can verify the created share card and view its appearance by navigating to the Demo Feed within your PantheraHive dashboard.
Now that the share card has been created and published to the Demo Feed, you may consider the following actions:
This concludes the "Quick Link Share" workflow. Your share card is now live on the Demo Feed.
\n