feat: Get-OpenGraph ( Fixes #2 )

Author: James Brundage

Commands/Get-OpenGraph.ps1

@@ -0,0 +1,62 @@
+function Get-OpenGraph 
+{
+    <#
+    .SYNOPSIS
+        Gets Open Graph metadata for a given URL.
+    .DESCRIPTION
+        Gets Open Graph metadata for a given URL.
+        
+        [Open Graph](https://ogp.me/) is a protocol that enables any web page to become a rich object in a social graph.
+
+        It is used many social networks to display rich content when links are shared.
+        
+        This function retrieves the Open Graph metadata from a given URL and returns it as a custom object.
+    .EXAMPLE        
+        Get-OpenGraph -Url https://abc.com/
+    .EXAMPLE        
+        'https://cnn.com/',
+            'https://msnbc.com/',
+                'https://fox.com/' |
+                    Get-OpenGraph        
+    #>
+    [Alias('openGraph','ogp')]
+    param(
+    # The URL that may contain Open Graph metadata 
+    [Parameter(ValueFromPipeline, ValueFromPipelineByPropertyName)]
+    [Uri]
+    $Url,
+
+    # A dictionary of additional Open Graph metadata to include in the result
+    [Parameter(ValueFromPipelineByPropertyName)]
+    [Collections.IDictionary]
+    $Data
+    )
+
+    begin {
+        # Make a regex to match meta tags
+        $metaRegex = [Regex]::new('<meta.+?/>','IgnoreCase','00:00:00.1')
+    }
+
+    process {
+        # Declare an empty object to hold the Open Graph metadata
+        $openGraphMetadata = [Ordered]@{PSTypeName='OpenGraph'}
+        if ($Url) {
+            $restResponse = Invoke-RestMethod -Uri $Url
+            foreach ($match in $metaRegex.Matches("$restResponse")) {
+                $matchXml = "$match" -as [xml]
+                if ($matchXml.meta.property -and $matchXml.meta.content) {
+                    $openGraphMetadata[$matchXml.meta.property] = $matchXml.meta.content
+                }
+            }
+        }
+        if ($Data) {
+            foreach ($key in $Data.Keys) {
+                $openGraphMetadata[$key] = $Data[$key]
+            }
+        }
+        
+        if (-not $openGraphMetadata.Count) { return }
+
+        [PSCustomObject]$openGraphMetadata                
+    }
+}